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WELCOME 
to The MagPi 82 


oding is a life-changing skill. One of my first memories is 
C creating a platform game at school; even though I loved coding, 
I went on to study English and take up a career in journalism. 
That was before Raspberry Pi and online training came along. A series 
of courses in Computational Thinking and Computer Science enabled 


me to pick up where I left off as a child. Coding had changed, but so Hattersley 
had I: Scratch made it easy to visualise programs, and Python replaced Editor of The MagPi. 
BASIC. A greater focus on making fired my imagination. Computer UN 
science and coding also led me to Raspberry Pi, where I ended up Dur de cum 
editing this fine magazine. ur rs 
The Raspberry Pi was created to increase the number of students ша ReneS, 


magpi.cc 


learning code and computer science. Needless to say, it was a roaring 
success. Almost a year since winning the prestigious MacRobert award, 
Raspberry Pi now finds itself stamped into history by the Royal Mail, 
which is celebrating 50 years of British engineering. It joins the likes of 
the Harrier Jump Jet in a special set of postage stamps (page 6). 

With the Pi’s prestigious prizes and Cambridge University history, RASPBERRY 
you might be forgiven for thinking 
that coding isn’t for you - it’s for 
engineers and students, and you’ve 
missed the coding boat. Nothing is 
further from the truth. Our feature 
(page 26) will get you started. 
Anybody can learn to code; everybody 
should learn to code. 


ZERO W KIT 


ZING JAM HATS 


Lucy Hattersley Editor 
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DISCLAIMER: Some of the tools and techniques shown in The MagPi magazine are dangerous unless used with skill, experience, and appropriate personal protection equipment. While 
we attempt to guide the reader, ultimately you are responsible for your own safety and understanding the limits of yourself and your equipment. Children should be supervised. Raspberry 
Pi (Trading) Ltd does not accept responsibility for any injuries, damage to equipment, or costs incurred from projects, tutorials or suggestions in The MagPi magazine. Laws and regulations 
covering many of the topics in The MagPi magazine are different between countries, and are always subject to change. You are responsible for understanding the requirements in your 
jurisdiction and ensuring that you comply with them. Some manufacturers place limits on the use of their hardware which some projects or suggestions in The MagPi magazine may go 
beyond. It is your responsibility to understand the manufacturer's limits. 
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Raspberry P1 becomes 
first-class stamp 


Royal Mail '50 Years of Engineering' series recognises role of ground-breaking 
mini computer. Rosie Hattersley reports on this prestigious recognition 


We've been convinced of its brilliance 
ever since the idea of an ultra-affordable, 
incredibly adaptable, and very tiny computer 
for coding was first mooted. Now, our beloved 
Raspberry Pi has been honoured by appearing on 
one of six Royal Mail stamp designs celebrating 
50 years of British engineering. 

Liz Upton, Raspberry Pi's Executive Director 
of Communications, announced the incredible 
news that from 2 May, Raspberry Pi fans would 
be able to get their hands on a brand-new Pi 


T he Raspberry Pi is a marvellous idea. Ж 


nA 
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A The stamp series celebrates 50 years of British engineering 


collectable - a special-edition stamp. Liz said, 
*We're absolutely made up to be one of the 
engineering projects chosen: we’re in some 
exalted company.” 

The Raspberry Pi stamp joins the Harrier 
Jump Jet, catalytic converter, Falkirk 
Wheel, synthetic bone-graft substitute, and 
superconducting magnets as world-class 


LOLOL 


C examples of British engineering. 
A с Special first-day cover commemorative 
5 М presentation packs, containing all six 
j : 2 engineering-focused stamps, can be 
k | 2 Raspberry Pi microcomputer 0 bought for £13 from the Royal Mail website 
now be found ona | helps to teach programming «5  (magpi.cc/zVBgUX) and at some Post Office 
first-class stamp 1 e р: POUT ч. „мт? ie died 


counters. A sheet containing one of each of the 
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Royal Mail Stamps 


British Engineering 


Raspberry Pi microcomputer The Falkirk Wheel rotating boat Three-way catalytic converter Crossrail created 26 miles (42km) 
helps to teach programming lift connects Scottish waterways reduces pollutants in car exhaust ` of new rail tunnels under London 


£7.60 


M 


Superconducting magnet allows Synthetic bone-graft material 
high-quality imaging in MRI encourages new bone growth 


2 The honour of appearing on a stamp comes $ 
two years after the Raspberry Pi won the Royal 
Academy of Engineering MacRobert Award Ø 


computer 5 The Falkirk Wheel rotating boat с 
gramming lift connects Scottish waterways $ 


A. The Royal Ma six engineering stamp designs costs £7.70. At 
engineering stamps а ооу уча суу 
bresenlation imita larger Post Offices you can also buy a sheet of Ф £155: 
will delight first-day Raspberry Pi first-class stamps. 
cover collectors 
P Buy the complete set of Leaping ahead 
engineering stamps as я 5 А 
a sheet from Royal Mail The engineering series of stamps has been 
published to coincide with the 5oth anniversary quar 
еб 


exhaust * of new гай tunnel 


of the Harrier Jump Jet. The honour of appearing 
ona stamp comes two years after the Raspberry 
Pi won the Royal Academy of Engineering 
MacRobert Award (magpi.cc/LzNeDT). The 


Stamp designs € 


Royal Mail Group Ltd. prize recognised the Pi's role in reversing the 

Reproduced by kind downward trend in interest in computer science 

permission of Royal . 

Mail Group Ltd. and programming. The stamps also honour 50 Superconducting magnet allows ў Synthetic bone-graft material с 
All rights reserved. years of the MacRobert Award’s existence. M ES P MT Sere D Dank rM, Y 
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Cloud 107. Connector 


Packed with data- 
gathering sensors, the 
board contains a secure 
chip for connecting 

to Google Cloud loT 
Core for analysing 

the information 


Coral Environmental 
Sensor Board 


Google launches new board for Pi with sensors and Google Cloud integration. 


By Lucy Hattersley 
oogle has released a new Raspberry Pi 
G product under its Coral brand (previously 
AIY Projects). The Environmental Sensor 
Board adds a range of sensors and a 128x32 OLED 
display to the Pi. 

More importantly, the board is designed to 
connect securely to Google’s Cloud IoT Core 
service (cloud.google.com/iot-core), enabling 
you to securely transmit data and perform detailed 
analysis on it (with Google's range of ML tools). 

The Environmental Sensor Board connects 
to Google IoT Cloud platform via a Microchip 
ECC608 crypto chip with Google keys. 

On the board, you'll find a HDC2010 humidity 
sensor, OPT3002 ambient light sensor, and 
BMP280 barometric pressure sensor, along 
with UART, PC, and PWM connections. A full 
datasheet can be found here: magpi.cc/uxHKEE. 

The new board also sports four Grove 
connectors (magpi.cc/eCbZbF), enabling you 
to quickly attach additional components for 
prototyping without needing to use jumper wires 
or a soldering iron. 
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Environmental Sensor Board 


Google has documentation for a couple of 
Python classes, both of which we’re looking at 
closely for potential The MagPi tutorials. The 
first is coral.enviro.board, described as “an 
interface for all input and output modules”; the 
second is coral.cloudiot.core, which “manages a 
connection to Google Cloud IoT Core via MQTT, 
using aJWT for device authentication.” Both can 
be found at coral.withgoogle.com/docs. 

The Environmental Sensor Board costs £20.62 
/ $24.95, and is available now from Mouser.com 
(magpi.cc/fnebgR). El 


A The Environmental 
Sensor Board packs 
four Grove connectors 
that make prototyping 
faster and easier 
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Yuri 3 Mars rover 


John 
Chinner 


John is an engineer 
and STEM 
ambassador at 
Airbus UK. He 
worked on the 
Astro Pi project, 
testing the 
Raspberry Pi units 
sent into space. 


magpi.cc/O0maUK 


Yuri 3 sitting 
alongside 
Featherstone and 
Rocky Rover at the 
Pi Wars 2019 event 
Credit: Harry Brenton 
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In Mission Mode, 
Yuri can be set 


to live-stream its 
journey across 
Mars's terrain while 


young scientists 
control it remotely 


Airbus engineer John Chinner unveils the secrets 
behind his Pi-powered Yuri 3 Mars rover to a 


delighted Rosie Hattersley 


Apollo moon landing, this year's Pi Wars 
was space-themed. Visitors to the two-day 
event - held at Cambridge University at the end of 
March - were lucky enough to witness a number 
of competitors and demonstration space-themed 

robots in action. 

Among the most impressive was the Yuri 3 mini 
Mars rover which was designed, lovingly crafted, 
and operated by Airbus engineer John Chinner. 
Fascinated by its accuracy, we got John to give us 
the inside scoop. 


| n honour of the 50th anniversary of the 


Airbus ambassador 

John is on the STEM ambassador team at Airbus 
and has previously demonstrated its prototype 
ExoMars rover, Bridget (you can drool over images 
of this here: magpi.cc/btQnEw), including at the 
BBC Stargazing Live event in Leicester. Realising 
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А John snuck Yuri 3 onto Airbus's Mars yard and gave 
it a test-run on a proper Mars test environment 


the impressive robot's practical limitations in 
terms of taking it out and about to schools, John 
embarked on a smaller but highly faithful, easily 


transportable Mars rover. His robot-building йа. ой 
experience began in his teens with a six-legged =з: 


robot he took along to his technical engineering 
apprenticeship interview and had walk along the 
desk. Job deftly bagged, he's been building robots 
ever since. 


Ш The part more challenging 
for home users is the 'gold 
thermal blanket’ @ 


Yuri is a combination of an Actobotics 
chassis based on one created by Beatty Robotics 
(beatty-robotics.com), 3D-printed wheels, and 
six 12V DC brushed gears. Six Hitec servo motors 
operate the steering, while the entire rover has an 
original Raspberry Pi B+ at its heart. 
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Yuri 3's Actobotics chassis is 
based on one used in rovers 
built by Beatty Robotics for a 
science museum 


John designed, built, and 
3D-printed the individually 
controllable wheels from 
scratch, while a Raspberry 
Pi B* acts as Yuri 3's brain 


Quick FACTS 


» Prior to building 
Yuri 3, John was a 
Python novice 


Most of the 
development work 
took place on his 
mother-in-law's 
dining table! 


v 


John was 
responsible for the 
shock, vibration, 
and EMC testing on 
the Astro Pi units 


v 


Yuri 3 usually runs in ‘tank steer’ mode. Cannily, 
the positioning of four of its six wheels at the 
corners means Yuri 3’s wheels can each be turned 
so it spins on the spot. It can also ‘crab’ to the side 
due to its individually steerable wheels. 

The part more challenging for home users is the 
‘gold thermal blanket’. The blanket ensures that 
the rover can maintain working temperature in 
the extreme conditions found on Mars. *I was very 
fortunate to have a bespoke blanket made by the 
team who make them for satellites," says 
John. “They used it as a training exercise for 


Jim Henson's 
animatronic 
puppets were his 
original inspiration 


v 


v 


The gold blanket 
protects the 
rover in extreme 
conditions (as 


. A Yuri 3 being tested on a beach to recreate challenging 
the apprentices. Е terrain navigation found on Mars) 
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Building a Mars rover 


pS eT 


* ® М 
>> 


01 Yuri 3's chassis is based on a Beatty Robotics 
one, but the rover was designed and built by 
John. Some parts come from Actobotics, while the A Yuri 3 explores the John has made some bookmarks from the 


М атое СМІ Th Martian landscape.. 
Seeking motors ete standard RE style cervos The only kidding - it's the leftover thermal material which he gives away to 


gold blanket was bespoke-made for accuracy (but local beach chodis touse as Dizes 
isn't required to function on Earth). P ` 


Rover design 
While designing Yuri 3, it probably helped that 
John was able to sneak peeks of Airbus's ExoMars 
prototypes being tested at the firm's Mars Yard. 
(He once snuck Yuri 3 onto the yard and gave ita 
test run, but that's supposed to be a secret!) Also, 
says John, “I get to see the actual flight rover in its 
interplanetary bio clean room". 

His involvement with all things Raspberry 
Pi came about when he was part of the Astro 
Pi project, in which students send code to two 
Raspberry Pi devices on board the International 


02 Yuri 3 has six separate servo motors, all 


controlled with Python. John operates the P With its six ; 5 ; Р 
robot using a combination of Nintendo Wii Remote individually steerable Space Station. “I did the shock, vibration, and 
and Nunchuk controllers to manoeuvre the chassis plist be aoe EMC testing on the actual Astro Pi units in Airbus, 
and head respectively. handle rough terrain Portsmouth,” John proudly tells us. 


— 
= 


03 In 'mission mode' you get a rover-centric live- 

streamed view. Yuri follows commands entered 
by students in a classroom using the menu-driven 
Python script. Meanwhile, an audience watching in the 
school hall witnesses them attempt to avoid obstacles 
and seek a hidden alien. 
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W John's daughter, and budding space-flight engineer inspects 
an earlier version of Yuri 3 - note the original red wheels 


m what a fantastic — 
opportunity for Er са 


exciting outreach Л 


A very British rover 
As part of the European Space Agency mission, 
ExoMars, Airbus is building and integrating the 
rover in Stevenage. “What a fantastic opportunity 
for exciting outreach,” says John. “After all the fun 
with Tim Peake's Principia mission, why not make 
the next British astronaut a Mars rover? ... It is 
exciting to be able to go and visit Stevenage and see 
the prototype rovers testing on the Mars Yard." 
John also mentions that he'd love to see Yuri 3 
put in an appearance at the Raspberry Pi store; in 
the meantime, drooling punters will have to build 
their own Mars rover from similar kit. Or, we'll 
just enjoy John's footage of Yuri 3 in action and = 
perhaps ask very nicely if he'll bring Yuri along for "Don't let anybody tell you you cant do anything" 
a demonstration at an event or school near us. Tim Peake 

John blogged the first year of his experience -R 
building Yuri 3 on his blog (magpi.cc/oomaUK). 
And you can follow the adventures of Yuri 3 over on 


j . A The gold blanket is used to keep the Mars rover safe in extreme temperatures 
Twitter (QYuri 3 Rover). [4| Leftovers have been used to create bookmarks as rewards for students 
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Telepresence Hand 
for Hazardous Areas 


Manipulate objects at a distance without using space wizard powers, thanks 
to this remote-controlled robo-arm. Rob Zwetsloot tries it on for size 


Telepresence Mand for Hazatdous Areas 


here’s a scene at the start of eighties classic 
Short Circuit where Steve Guttenberg is Bloch Diagram 
hiding away in a lab, programming a robot 
Andrew hand that is playing the piano. It's quite quaint by 
Loeliger today's robotic standards (and was probably just a Glove Control Robot Hand 
i ich i D ae 
puppet at the time), which is only more apparent f E" = 
A fourth-year D : ) В : ; k 
when viewing Andrew Loeliger’s university project Base Vimo Hand Servo 
student at the 8 8 ty ргој Feather Station | Controller Board 
University of from the last year. 
Strathclyde “T set out to provide a solution to the issue 
studying Electronic of first line responders operating in dangerous A Here's the breakdown of how the system works 
and Electrical » And lai “Bomb di Isit 
Engineering. areas,” Andrew explains. "Bomb disposal sites, 
biohazardous areas, and nuclear hot zones are all The user wears a glove that”s connected to a 
crucial areas where human intervention would be "base station”, which also has a display. The display 
required but could be potentially life-threatening. shows the pictures from a wirelessly connected 


The aim of the project was to develop an extremely camera, which is part of the remote robot hand 
low-cost robotic hand that can operate in hazardous system. The glove has a series of sensors to record 


areas and perform dextrous tasks while being how the fingers and hand are moved, and that is 
Y There's currently no controlled and viewed remotely. The visual feedback then relayed to the hand controller. 
Wist movement an provided by the system allows the user to control 
the glove, but this А А 
can be easily added every movement of the hand as if they were there.” Hand print 


“The bulk of the robot hand comprises 3D-printed 
components,” Andrew tells us. “The design files 
for the 3D-printed components were sourced from 
InMoov. The 3D-printed robot hand is designed 

to hold all of the servos needed to mimic user 
movements made in the glove remotely. To control 
the robot hand, there is the Raspberry Pi Zero W 
which takes the received values from the base 
station and sends them to the servo driver board to 
move the servos. There is one servo for each finger 
and each finger is moved via a braided fishing line 
pulley system within the finger." 


Robotic mimicry 

The hand works very well, according to Andrew: 
“The project worked as hoped and is simple to 
use, as the user simply needs to put the glove 
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This 3D-printed robot arm 
perfectly captures the 
movement of the user 


qj 


Quick FACTS 


» The idea is inspired 
by giant robot flick 
Pacific Rim, albeit 
much smaller 


v 


Andrew designed 
a custom PCB for 
the project 


It should be more 


The glove contains effective than 


multiple flex sensors to І ргергодгаттеа 
The base station automatons 


connects it all together, 


giving a video view of The Pi's size and 
[ the remote hand as well power make 
| 


v 


figure out how you're 
using your fingers 


v 


it perfect for 
this project 


The wrist-turning 


Ш The user simply needs to servo is actually 


already in place 


put the glove on and move 
their hand to make the 
robot hand work Л 


on and move their hand to make the robot hand 
work. One of the really nice features is that there 
is low latency between the glove and robot hand 
movements, which means the hand truly mimics 
the user's finger movements." 

Andrew has plans to improve the design with 
a new version that makes use of Bluetooth Low 
Energy for the glow, along with sensors so the 
hand can turn at the wrist, and perhaps a haptic 
feedback system as well. 

There is one final use case that Andrew has 
found: “Although I originally considered this 
project for hazardous areas, interest has been A Aenesstserves controls tha 
shown іп it from a prosthetics point of view." El individual digits on the robot hand 
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| The OpenSprinkler Pi HAT allows 
makes use of a Raspberry Pi's 
GPIO pins to directly access and 


control sprinkler valves 


Cat shower NF 


The OpenSprinkler Pi 
software needs to be | 
| 


installed on the Raspberry Pi 


By integrating the 
Raspberry Pi into the 
sprinkler setup, it can be 
reachable from the internet 


Curiosity killed the cat, but water deterred them from pooping 
in Davide Magni's garden, as David Crookes explains 


bw 
Davide 
Magni 


Davide is a 
telecommunications 
engineer who is 
addicted to art and 
design. He has been 
a programmer for 
15 years. 


tidal.it 
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he internet loves cats and they are indeed 

very cute. But when they're 'feline' in the 

mood for pooping, there's a good chance 
one will paw-se for a short spell in your garden and 
leave you to clear up the mess. 

That happened to Davide Magni's cousin, who 
moved into the house next door to him in Italy. 
*She spent more than a week cleaning her garden 
of cat-droppings,” he recalls. “All the cats in the 
area were using that small piece of land as their 
litter and I wondered how I could prevent it from 
happening in my own garden in the future." 

As it happens, Davide was rearranging an 
irrigation system in his garden when he began to 
consider a solution. “I started to place sprinklers in 
key locations, looking for a way to equally wet the 
whole garden using trial-and-error and activating 


them manually," he says, before realising they 
could serve a dual cat-chasing purpose. 


Sprinkle of Pi 

The first important thing was automating the 
system so that it could be used when Davide was 
away from home or if he forgot to activate it. “1 
decided to use a Raspberry Pi because I wanted 
something that would provide APIs and integrate 
with other Internet of Things devices I have at 
home,” Davide tells us. “I certainly didn't want 
a closed, self-contained system that wouldn't 
interact with other devices." 

Luckily, there is an open platform which 
allows irrigation systems to be controlled: called 
OpenSprinkler, it supports the Pi, has its own 
extension board, and is connected to the web for 
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4 And it's off: the 
camera catches 
the moment a cat 
is squirted with 
water. It's soon 
over the gate 


| (Om | ANN 


ANN 


> OpenSprinkler 
Pi ($75) is at the 
project's heart 


> It makes use 
of an extensive 
sprinkler system 


> Cats are detected 
by a smart camera 


> Sprinklers are 
activated to chase 
them away 


> No cats are harmed 
by the water 


remote access. "It provides everything I need for 
good irrigation control such as daily programming, 
a web GUI, and weather-based prediction,” Davide 
continues. With that in place, it was time to turn 
his attention to those troublesome cats. 


2 My cousin spent more 
than a week cleaning her 


garden of cat-droppings Ø NEM ГЕТЕ 

that runs a small script. This decides if the shower excavation for the 
needs activating and sends it to OpenSprinkler. laying of the water 

Pi spy cats “I added a callback, a simple PHP script call, Break Edere 

Davide's wife had bought him a Netatmo that is invoked directly from the camera every RS tb luis 

Presence outdoor smart camera as a Christmas time it detects a movement,” says Davide. “The part of the project 

gift. It detects movement, shines a bright light, script verifies that the call is valid, checks the 

and records what it sees; it can also distinguish system status, sends the activation signal to 

between people, animals, and vehicles. As such, it OpenSprinkler, and logs the event.” 

was the perfect input device. Now, when a cat strays into the garden, the 

Initially, he pushed the Netatmo trigger through sprinklers kick in within seconds and chase them 

IFTIT to send a notification that activated the away, but there are some pitfalls. “For future 

sprinklers, but it took so long that the cats would developments, I'm thinking about being able to 

have done their business and already left. To keep a small history of events in order to avoid 

improve performance, he created an ad-hoc activating a shower if a person and an animal 

application with Netatmo Connect which receives approaches - such as my mum passing with her 


the camera trigger and sends it to a self-hosted site dog,” he laughs. M 
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DIY Hardware 
Password Keeper 


Do you use Password123 for all of your online services? David Crookes looks at 
a Pi Zero-based device that should help you come up with more secure logins 


xperts suggest that we should use a With this in mind, Eugene got to work. He 
Е different password for every online service wanted to create a device that couldn't be hacked 
4 we access, but, as many users know, trying remotely over a network. What's more, he didn't 
to remember them all can be rather difficult. want users to have to type in a password to unlock 
Better, then, to have a secure and convenient the device and he wanted it to be relatively small, 
system that can store and recall them for you, with secure and encrypted storage. 
» which is why Eugene Dzhurynsky has created 
a hardware password storage device based Securing the system 
Eugene i iof Encryption, he says, was the easy part. “I could use 
Dzhurynsky around a Raspberry Pi Zero and radio frequency тур { ys, Ур : 
identification (RFID) technology. any industry standard encryption," he explains. 
Eugene is a Inspired by a thread on Reddit which explained The tricky aspect was the key - the component 
Ukrainian software how the Pi Zero could function as a USB device, that would unlock the encrypted file containing a 
engineer living Eugene noted that the Pi Zero could control user's passwords. 
isis NE another computer and act as a keyboard. “It Eugene intended to store the passwords on the 
and he is currently was a ‘wow’ moment and I was stunned by the Pi Zero, so he figured that placing a private key on 
working as a possibilities," he recalls. an RFID fob would work well. With the Pi-based 


data engineer 

and machine- 
learning specialist. 
magpi.cc/SELOuy KN F 
The user presses the buttons to à 
the right of the screen, letting 

them navigate and select a 


password they want to use 


As long as the password-input field on a web When this rightmost button 
form or application is expecting an input, the is clicked, the Pi Zero sends 
password will be inserted in the same way as the password down a USB 
if the user were typing it themselves cable to the computer 


STI 
E 
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A When activated, the screen shows accounts that have stored 
passwords and allows them to be used on a linked computer 


device wired to an RFID card reader and connected 
to a computer, he reckoned a user would only need 
to bring the fob close to unlock the device and 
allow the passwords to be accessed and shared. 

A user could then log in to whatever service they 
were trying to access. 

Certainly, the Pi Zero proved the perfect fit. “It 
has a Linux OS, it's easy to manage, it's developer 
friendly, and it has enough memory and network 
adapters," Eugene says. He coded it using the ] 
programming language Go (golang.org) and he ap ne Sas | > The device 
fitted the device with a small OLED SPI display A The RFID RC522 sensor is inexpensive and allows this system Stores:enerypted 
before allowing it to be controlled via some to become unlockable only when an RFID key fob is presented passwords 
buttons positioned on the front. All were placed 
in a self- made case. computer, they won't be able to access passwords." 

And yet the system is not quite perfect. *The key 
can be compromised if it's used with some cheap 


Quick FACTS 


The software was 
built using the 
language Go 


v 


Шш | do n't use It to keep my RFID cards,” Eugene admits. “But if you just keep лаке шеа 
own D asswo rds z it's j u st ая ай RFID- protective cover, then it's going RFID key fob 
a D et D roj act [Л So could it be used as a professional toolin its > Рае аав аге 
current state? *Tough question," replies Eugene. added via a 
“I don’t use it to keep my own passwords, that's web interface 
Playing it safe the answer. But it’s just a pet project and there are 
In order to add and manage the passwords, many things to be added before it will become truly я E 
Eugene then made use of a web interface which safe and secure." föcoghition 
was put together with the help of friend Maxim Indeed, he wants to add backup and restore 
Vassilyev. "Pi Zero can present itself as network options for the internal storage and RFID key, and 
interface as well as a keyboard so by navigating he wishes to improve the web interface, add a help 
to the local address http://10.101.1.1, the web section, provide an easy way to add more keys and 
interface for the password management will be users, have the device generate passwords, and 
accessible,” Eugene explains. add a real-time clock for random seed generation. 
He says it only works in the presence of the “People seem to like the approach Гуе been 
fob: *So if someone will try to plug the Pi into a taking,” he says. M 
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Pi VizuWall 


This Raspberry Pi cluster has moving parts and a serious 
goal to help train programmers. Phil King finds out more 


Matt 
Trask 


Matt is a Researcher 
and Chief Engineer 
at the FAU Machine 
Perception and 
Cognitive Robotics 
Lab and is grateful 
o the FAU Office 

of Undergraduate 
Research and 
nquiry for its 
financial support for 
his project. 
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ounted on a clear acrylic plate, twelve 
M Raspberry Pi boards suddenly spring 

into life, moving outwards, as if waving 
to the attendees at Maker Faire Miami. Not just 
a cool effect, the movement is proportional to 
each Pi's level of activity in a parallel computing 
cluster. This is Pi VizuWall, a project created by 
long-time computer engineer Matt Trask during 
his degree course at Florida Atlantic University 
(FAU), while doing research into a new class of 
supercomputer systems. 

“When I am successful (heh, nearly said ‘if? 
there...), it will obsolete MPI [Message Passing 
Interface] as the main means of programming 
distributed compute clusters,” explains Matt. 
“This means that my variant of the Beowulf 
architecture will function as a distributed 
symmetric multiprocessing system that appears 
to be a single unified system that is the sum of 
all RAM and all cores in the cluster: a virtual 


| 
A cluster of twelve Pi 
3B nodes communicate 
via wired Ethernet 


Micro servos are embedded in 
3D-printed housings, but the 
latter will be replaced by CNCed 


mainframe computer. Perhaps the solution to the 
so-called Ninja Gap?" 

Matt is referring to the difficulty of enabling 
computer science students to obtain enough early 
experience programming parallel computing 
systems to become industry- proficient. Hence his 
motivation for building a low-cost cluster system 
with Raspberry Pi boards, in order to drive down 
the entry-level costs. 


Moving parts 
Matt reveals how Pi VizuWall works: “Each node is 
capable of moving through about 90 degrees under 
software control because a small electric servo 
motor is embedded in the hinging mechanism. The 
acrylic parts are laser-cut, and the hinge parts have 
been 3D- printed for this prototype." 

While the original concept was to also use LEDs 
to edge-light the acrylic plate and change the 
colours to indicate CPU usage, Matt says the idea 


Each Pi is mounted on a hinged 
acrylic panel, capable of 
moving out up to 90 degrees 
under software control 


aluminium ones in the next version — —— — 
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9 Hinges and housings 
were 3D-printed, while 
the acrylic panels were 
laser-cut 


» This prototype 
was created to 
justify the cost of 
building a much 
larger version 


» PoE will be used 
to simply power 
distribution in the 
next iteration 


> Matt has been a 
computer engineer 
for nearly 40 years 


m The physical motion helps 
student programmers 
understand their 
system utilisation EZ 


» He wrote the first 
virtual machine 
software on the 
80386 processor 
in 1986 


» He got his first 
Raspberry Pi 
in 2012 


of the moving boards was always fundamental to 
the project: *I figured that the physical motion 
would help student programmers understand their 
system utilisation. And it looks cool.” 

Although Matt came up with the project's 
concept several years ago, he only started building 
it in late 2018. *I collaborated with Art Rozenbaum 
(FAU Mechanical Engineer) over the fall to develop 
the concept and submitted my research proposal in 
November," he tells us. *Art and I worked through 
my original concept for mounting the servos 
behind the board and pivoted to his concept of 
embedding them in the hinge mechanism, a much 
cleaner solution." 


Currently, the Raspberry Pi boards have wired baulked at the estimated cost of $20-25,000 and A. Ethernet cables 
communication via a 14- port Ethernet switch, suggested a scaled-down prototype first.” seh АР 
but Matt is looking into making it wireless. This Matt says some lessons have been learnt in the its hinged panel, so 
will involve *evaluating whether the Pi's wireless process of building it, including plans to replace ite DE 
LAN capability is suitable for carrying the MPI the 3D- printed plastic motor housings - which 
message traffic, given that the wired Ethernet has suffered minor distortion due to heat from the 
greater bandwidth." servos - with CNCed aluminium. “This will [also] 

permit us to have finer resolution when creating 
Scale model the splines that engage with the shaft of the servo 
The original plan for Pi VizuWall was to create a motor, solving the problem of occasional slippage 
4x8 ft (1.2x2.4 m) wall with 300 Raspberry Pi boards under load that we have seen with this version.” 
wired as a Beowulf cluster running the MPICH The ultimate goal is to *create a massive piece 
implementation of MPI. *When I proposed this of kinetic art to embellish the entryway to our new 


project to my Lab Directors at the university, they Lab facility at the university." El 
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MägPi 


The Raspberry 


P1 Hologram 
Machine 


wondering what to do with a spare 17-inch monitor, 
Dan Aldred teamed it with an old IKEA table and an 
acrylic pyramid, The results are truly hologramtastic, 
as Nicola King discovers 


€ 


Dan 
Aldred 


an, a secondary school teacher, was 

chatting one day with his students about 

a hologram hack that some of them had 
developed using a mobile phone and an old CD 
case, as he explains: “The phone lies flat ona 
surface of the screen and a small, we are talking 
probably around 5cm max, inverted pyramid sits 
on top of the screen. I asked one of the students 
if you could flip the pyramid and still create the 
hologram. They said, yes, if the screen is at the top 
rather than the bottom." 

So, armed with this snippet of inspiration, Dan 

decided to model his very own version: *I wanted 
to create a large standalone machine that would 


Raspberry Pi 
enthusiast, NCCE 
acilitator, teacher, 
and coder who 
enjoys creating new 


projects and hacks 
o inspire others 

o start learning. 
Still trying to get a 
inect 360, Python, 
and Pi working with 
each other. 


magpi.cc 


display holograms and let the users select them 
with buttons. I also knew that it would make a good 
centrepiece for open evenings!" 


Building a pyramid 
Simple in design, Dan's idea developed quickly. 
His first issue concerned the dimensions of the 
pyramid, which he made himself out of acrylic 
using a laser cutter. “The main focus of the build 
was on the calculations for the pyramid, to ensure 
that it was the correct size for the screen," says 
Dan. *I had a spare screen which I wanted to 
reuse, rather than buying a new one. I also had an 
old IKEA coffee table which I upcycled to hold the 
screen and house the pyramid. Basically, I cut the 
legs in half and used one half for the base legs, and 
the other for the monitor supports." 

So, how does this machine work exactly? Dan 
explains, “A screen is supported above a clear, 


The Raspberry Pi Hologram Machine 


The four projected images 
combine into one, appearing 
as if inside the pyramid 


Dan built the pyramid 


from laser-cut acrylic 


four-sided pyramid. The Raspberry Pi А+ runs a 
Python program on bootup, which plays videos 
from a folder. These are ‘hologram’ videos which 
contain the same image orientated in four different 
angles: front, back, left, and right. The acrylic 
reflects back the image from the overhead screen, 
creating the illusion that a single solid object 

is floating in the middle of the pyramid. As you 
view the pyramid from a different side, you see a 
different perspective.” Dan has also added three 
buttons - coded with the GPIO Zero library - to 
pause a video, skip to the next hologram, and shut 
down the Raspberry Pi. 


3D fun 

As with many projects, a little fine-tuning was 
required to ensure it all worked as Dan had 
envisaged. For example, he had to be careful what 
videos he used in the machine: “I had to search 
for inverted videos as the most popular videos are 
designed for the phone version with the upside- 
down pyramid. This means that, when playing a 
video in my Hologram Machine, they were 

upside down.” 


Ш | wanted to create a large 
standalone machine that 
would display holograms Ø 


One would guess that you could make the 
Hologram Machine any size, then, as long as your 
screen is big enough? *On posting the completed 
project on Twitter, one of the first responses 
was a retweet with the idea that I should use a 
projector as the screen and build a giant one-metre 
hologram! So yes, as long as the screen is big, you 
can increase the size of the pyramid and create a 
larger hologram," reckons Dan. 

As to the future, he says that he would like to 
develop the Hologram Machine with an HDMI 
monitor, so as to improve hologram quality. *I 
am also looking at an alternative to the acrylic as 
it is difficult to keep clean!" he adds. *You only 
have to look at it and it gets dirty - perhaps a 
glass pyramid." El 
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The Raspberry Pi Hologram Machine 
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Special videos are 
played on an upside- 
down monitor 


Quick FACTS 


Dan's most 
popular hologram 
is the incredibly 
realistic lightning 


Videos must 

be inverted to 
show correctly in 
the pyramid 


The video player is 
based on code by 
Les Pounder 


The sawn table 
legs were filled with 
expanding foam 


Dan is working on 
a real-time night- 
vision camera 


magpi.cc 23 


Масрі | SUBSCRIPTION 


SUBSCRIBE TODAY 
FROM ONLY £5 


UPTO DO /o 
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SM learn scratch game 


when clicked 


AUTHOR 


set score + 


change score 


! wait @ secs 
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Me ee ed p28 START 
| Variables CODING WITH 
anno ! — SCRATCH 
p31 CODE A 
QUIZ GAME 
WITH PYTHON 
p34 MAKE AN 
LED TORCH 
L earning to code can be one of the most profound WITH PY THON 


skills you will ever develop. With code, you can 
control a computer. You can get it to do things for you, 


and also control gizmos and other computers. Kick back and 
let your computer do all the work. p35 BUILD AN 
Sure, that’s cool. But coding is about more than that. It’s ELECTRONIC 


about understanding how computers work, and getting a 
better understanding of how technology - and the modern GAME 
world - works. It's about breaking down problems into little 
bits and solving them. It's an amazingly helpful life skill. 
That's why it's profound. 
On a more practical level, knowing just a little code can 
lead to better job opportunities; a little more can open up 
well-paid and fun jobs. It’s an impressive skill to put on 
your CV and anybody can do it. Anybody. 
Coding is a lot easier than you think. And putting the 
power of computing and digital making into the hands of 
people is what Raspberry Pi is all about. 
The Raspberry Pi is ‘the little computer that could’, 
and you’re ‘the person who can’. Don’t worry: you’ve 
got this. We can help you get started. 


m The Raspberry Pi is ‘the little 
computer that could', and you're 
‘the person who сап’ E 
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Start coding 


it means you can get your computer to do 
whatever you want. Join us as we show you 
how to make your first programs using Scratch and 
Python. You'll also see how easy it is to build simple 
electronics projects. 

A program is just a set of instructions. In Scratch, 
the instructions are written with visual blocks that 
lock together to make a sequence called a script. 
The blocks are colour-coded to help you find 

them. To find the brown blocks, for example, 
click the brown Events button above the 
Blocks Palette. 
Scratch makes coding easier, because you 
don't need to worry about the spelling of 
commands. And everything is laid out in 
front of you. 


The Scratch screen is divided into units called 
steps. When the cat moves 10 steps, it only makes 
one movement, but that stride shifts it 10 positions 
across the Stage. The middle of the Stage is at 
X-0, у=0. The x-axis (left to right) runs from -240 
to *240, and the y-axis (bottom to top) runs from 
-180 to *180. The directions the sprite can move 
in are numbered o (up), 90 (right), 180 or -180 
(down), and -90 (left). You can use numbers in 
between those numbers too, so -45 would be a 


eing able to write programs is like a superpower: 


Beginners, arise! It's time to take your first steps with 
coding, as we introduce you to Scratch and Python, with 
a sprinkling of twinkling LEDs! By Sean McManus 


01 Start Scratch 2 
Open Scratch by clicking on the Raspberry Pi 
Menu icon and choosing Programming > Scratch 2. 
You will see Scratch interface and a single 
character in the top-left, known as ‘Scratch Cat’. 

To control the Scratch Cat, we're going to drag 
blocks from the Blocks Palette into the Scripts Area 
and join them together. 

Start by clicking on Events and drag the 
when . clicked) block to the Scripts Area. 

Now click on Motion and drag a 
point in direction 90 block and connect it the to 
the bottom of the (when _ clicked) block. 

Click on the fields in the blocks to edit the 
numbers. Click on ‘90’ and change it to ‘o’. 

Now click and drag the blocks below, and edit 
their numbers, to build a script for Scratch Cat. 
This script runs when you click the green flag 
above the Stage. It sets the cat’s movement 
direction to up, puts the cat in the top-left corner 
of the Stage, and sets it to always face left or right. 
Then, the movement blocks inside the (forever 
bracket keep the cat moving all the time. 

Click the green flag to run your script. Scratch 
Cat will move to the left side and bounce up 
and down. 
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north-west direction. Why not try starting a new 
project and joining some Motion blocks together 
to experiment? You can run a script or a block by 
clicking it, or use the when flag clicked block as 
we did in our program here. 
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02 Send a broadcast 

The moving objects in Scratch, including 
the cat, are called sprites. One sprite can send a 
message to all the other sprites using a broadcast. 
You can't hear it or see it on screen, but sprites 
can listen for it, and then start a script when they 
receive it. We'll use a broadcast to make the cat 
throw some bananas. Click the brown Events 
button, and add the two blocks below to the Scripts 
Area. This new script doesn't join to the existing 
script (from Step 1) - it sits on its own in the same 
Scripts Area. 

You need to change ‘message?’ to ‘fire’. Click 
the down arrow next to ‘message1’ in the broadcast 
block and choose New Message. Enter the message 
name ‘fire’ and click OK. 

As the program is running, when you tap SPACE, 
the broadcast message is sent silently. Crafty! 


when space 


key pressed 


broadcast fire 


03 Add aerodynamic bananas 

Scratch enables you to get results fast 
because it includes its own images and sounds. 
Click the first New Sprite button above the Sprite 
List (it will display ‘Choose sprite from library’ as 
you hover over it). 


FEATURE 


Blocks Palette: Find 
instruction blocks here 


Scripts Area: Drag and 
drop blocks here to build 
your script (program) 


when clicked 


wait @ secs 


stop all 


Buttons: Click to view 
different types of blocks in 
the Blocks Palette below 


Sprite List: Select and 
manage sprites here 


Click the Bananas sprite to add it to the Sprite 
List. Notice that its Scripts Area is blank. We'll 
give Bananas two scripts. The first one sets the 
sprite's size and makes it invisible when you click 
the green flag. The second runs when the cat 
broadcasts its fire message. Click and drag the 
blocks below to the Scripts Area. 
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Top Tip 


Get the 
right sprite 


Make sure you're 
adding scripts to 
the correct sprite. 
You can select a 
sprite by clicking 
it in the Sprite List. 


when I receive fire 


When adding the (glide block, drag the 
block inside the round ‘y:’ field to 
replace the ‘10’ default value. 

The ‘fire’ broadcast makes the bananas jump 
to the cat (use the go to mouse- pointer block, 
and choose Сай in its menu). Then it makes the 
bananas visible, glides them across the screen, and 
hides them again. 

Click the green flag, and tap SPACE to test. 
Scratch Cat now throws bananas. 
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when clicked 


set score to g 


7S 


Top Tip 


Blocks inside 
blocks 


Some blocks can 
go inside other 
blocks. In Step 3, 
the y position 
block keeps the 
sprite's y position 
the same while 
its x position 
changes. 


04 Add monkey magic 

Variables are names used to remember 
information, such as a score, that might change. 
Click the Data button and click Make a Variable. 
Give it the name ‘score’, select For All Sprites, and 
click OK. Let’s add a moving target for the cat to try 
to hit. Click the ‘Choose sprite from library’ icon 
and choose the Monkey2. Select Monkey2 in the 
Sprites area and give it the script above. 

The monkey’s script sets the new score variable 
to o when the game starts, then makes the monkey 
move up and down. Fach sprite can have more 

than one image: the Next Costume block cycles 
through them, creating an animation. 


05 Add collision detection 
Our monkey will react when it's 
struck by a bunch of bananas. To do that, 
we use an fif) block; this checks whether 


when clicked 


wait Є? secs 


stop àll 
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We're huge fans of Scratch at The MagPi, so 
check out our past issues online for more Scratch 
tutorials. Issue 5 includes a memory game, like 
Simple Brian. Issue 34 has a multiple-choice quiz, 
and our 2018 Annual included an introduction 


to electronics and Scratch. See issue 76 for 
a roundup of resources to help you learn 
Scratch, and don't forget there's a Scratch book 
in The MagPi's own Essentials series 
(magpi.cc/learnscratch) and the Code Club Book 
of Scratch (magpi.cc/ccbook1). 


change score 


wait @ secs 


something is true - in this case, whether the 
monkey is touching the bananas. If so, the blocks 
inside its bracket are run. Here, those blocks 
hide the monkey, add 1 to the score, and wait one 
second before showing the monkey again. 

This whole code chunk goes inside the monkey's 
forever) bracket - below the next costume. block 
- so the program keeps checking whether the 
monkey has been hit. 


06 Finishing touches 

Let's add a simple timer to stop the sprites 
moving after 30 seconds, and make the monkey 
react when it sees incoming bananas. Add these 
two scripts to the monkey sprite. Now the game is 
complete, why not try experimenting with it? Can 
you make the monkey move erratically instead of 
disappearing when it's hit? Can you change the 
sprites’ positions and directions to turn the game 
sideways, making it more like Space Invaders? 
What about adding more targets to hit? One of the 
best ways to learn to code is by experimenting with 
existing programs. 
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Code a quiz game 


Make your own text quiz game that mangles famous 


phrases using the Python language 


any people progress from Scratch 

to Python, a programming language 

that is powerful, easy to get started 
with, and much easier to read and write than 
other languages. 

We're going to make a simple quiz question 
generator that strips the vowels and shuffles the 
spaces in a phrase. The player has to work out what 
that phrase is. 

We’ll be using Thonny, which provides a 
friendly single-screen environment for running 
and testing Python code. Like Scratch, the Thonny 
IDE (integrated development environment) comes 
pre-installed in the Raspbian with Desktop and 
Recommended Software operating system. 


01 Create a list of questions 
As well as variables, Python has lists, which 
can store multiple pieces of information. Our 
program creates a list called questions. Each item 
in the list is a piece of text, known as a string. In 


Python uses indentation to show which 
instructions belong to a function, an if statement, 
or a repeating section. As you can see in Step 3 
(overleaf), you can have multiple levels of 


Ф ичо а а 


Мем Load Run Debug 
190417 only connect. py < 
t random 
questions - ["As you like it", " 
"Much Ado About 
"King Lear", ymbe 
"Love's Labour's Lo: 


chosen phrase 
chosen phrase 


random.choice(questions 
chosen phrase .upper( 


for letter in chosen phrase: 
ter in vowels: 
puzzle «- letter 
4 


Shell 


JLSCS R 
What is your guess? Julius Caesar 
That's correct! 


THLL 
What is your guess? Romeo and Juliet 
No. The answer is OTHELLO 


>>> | 


Python, strings are surrounded by double quotes 

to show where they start and end. The whole list is 

enclosed in square brackets, and there are commas 

between the list items. Type in the code below, save 
your program, and then click Run. If it worked, you 

should see no error messages in the Shell window. 


import random 


questions - ["As You Like It", 
"The Tempest", "Measure for Measure", 


Thonny - /home/pi/190417 only connect py (p 39:47 


Variables 


01 Type in and edit 
your program 
code here 


02 Enter direct 
commands and 
see program input 
in the Shell here 


Keep track of the 
03 
data your program 
is processing here 


indentation. The last line belongs to the if "Much Ado About Nothing", You'll Need 
instruction, and that is repeated inside the for | "The Comedy of Errors", 
loop. The best way to get the indentation right is "King Lear", "Cymbeline", Raspbian with 
to remember the colon at the end of the previous = eee К ү m Desktop and 
line. Then, Thonny will add the indentation for you аа ати Recommended 
automatically. If you forget, use four spaces at the "Love's Labour's Lost", Software 
start of the line to insert the indentation. You'll still "King John", "Julius Caesar", Thonny 


need to fix that missing colon, though! 


"Edward III"] 
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Where next? 


You can find Python code to dissect in most issues 
of The MagPi. Issue 53 (magpi.cc/53) includes 
a more in-depth beginner's guide to Python, 


T Ti Pick a random question А covering variables, looping with while and for, 
Op l p Python includes modules of prewritten branching with if, and functions, which we'll 
code you can use, such as the random module cover in this issue shortly. Issue 54 (magpi.cc/53) 
Pesky we imported in Step 1. The first new instruction introduces object-oriented programming in both 
punctuation! creates a new variable called chosen phrase and нае апе гушопыесце 73 \тасрсе/ 73) Р 
i Е х includes a roundup of Python books and online 
THe care to puts a randomiy chosen question into it. The resources. There is a book in our Essentials 
TE second line converts the chosen_phrase to upper series too, called Make Games with Python 
atithe send of case. Run the program a few times and look at the (magpi.cc/gameswithpython). 
be Ше] сїз value of chosen phrase in the Variables pane. You 
instructions. The should see different names come up, although 
code won't work names can also repeat. 
without them. Add a line of space between the code in Step 1 list. If it is not, the letter is added to the end of 
and add the following code: puzzle. The += means ‘add at the end’. Run the 
program, then test it's working by looking at the 
chosen phrase - random.choice(questions) contents of puzzle in the Variables panel. It should 
chosen phrase - chosen phrase.upper() contain no vowels, spaces, or apostrophes. 


Add the following code to the program: 


vowels [ 5 5 5 5 Д 5 ] 
Strip the vowels and spaces puzzle 
Let's create a new list of forbidden 
characters, chiefly the vowels, but also the letter chosen phrase: 
space and the apostrophe. That last list item in letter vowels: 
the vowels list is an apostrophe inside double puzzle letter 
quotes. We create an empty string variable, called 
puzzle. We're going to go through each letter in 
the phrase, check whether it's in the vowels list, 
and if not, add it to the end of the puzzle string. Insert random spaces 
The for instruction sets up a repeating piece Each character in the string can be referred 
of code, called a loop. The instructions that to by its position number, starting at о. The number 
should be repeated are indented from left. Each is called an index, and you put it in square brackets 
time around the loop, the variable letter is after the string. Try this in the Shell (click on the 
set to contain the next character from the line starting with ‘>>>’). Instructions in the Shell 
chosen phrase string. The if instruction are carried out immediately. Enter the following: 
checks whether the letter is in the vowels 
print( [1]) 


You get “е” back (because the first character is 
number 0). You can get a chunk too (called a slice) 
by giving a start and end index, like this: 


Debugging in Thonny 


You can step through the program slowly to see р [ШЙ 
what it's doing, which can help you to find errors. 
Click the Debug button in Thonny, then click the It gives you ‘ell’ because the last index position 
Over button to run through each instruction in turn. (4) is left out. We'll create a new list, called 
Watch the Variables pane on the right to see how puzzle with spaces, by adding chunks of the 


the lists and strings change at each stage of the 
program. Thonny also helps you avoid errors by 
highlighting unclosed brackets and double quotes. 


puzzle string and a space until there's no puzzle 
string left. The while loop repeats the indented 
instructions below as long as the length of puzzle 
is more than о. The group length variable is 
given a random whole number (integer) from 
1to 5. Then that many letters are added 
to puzzle with spaces from the front of 
puzzle, plus a space. Those characters are 
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FEATURE 


Python is easy to get started 
with and much easier to read and 
write than other languages 


then cut off the front of puzzle. The slicing here 
only uses one number, so the other one is assumed 
to be the start or end of the string. 

Add this code to your program: 


puzzle with spaces - 


while len(puzzle) > Ө: 
group length - random.randint(1,5) 
puzzle with spaces = 
puzzle[:group length] + " " 
puzzle - puzzle[group length:] 


Add collision detection 

It prints the puzzle with spaces.It then 
uses the input() function to ask you what your 
guess is. Your answer goes into the guess variable, 
and is then converted to upper case to make sure 
it matches the correct answer if it's right. The 
if instruction checks whether guess is the same 
as chosen phrase. If so, it prints one message. 
Otherwise, the instruction indented under else 
runs, to tell you the right answer. In Python, one - 
is used to put a value into a variable, but two (== 
are used to compare items in an if instruction. 

Add this code to the end of the program: 


print(puzzle with spaces) 
guess - input("What is your guess? ") 
guess — guess.upper() 


=` guess -- chosen phrase: 
print("That's correct!") 
else: 
print("No. The answer is 


, Chosen phrase) 


Click the Run button and hopefully you'll see some 
letters in the Shell and ‘What is your guess? Enter 
an answer and you'll see ‘That’s correct!’ or ‘No. 
The answer is! and the correct response. 

If you've typed the code out by hand, it's likely 
that you'll see an error message. Go through your 
code line-by-line and compare it to the full code 
inquiz game.py. 


quiz game.py 


002. 
003. 


004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 
020. 
021. 
022. 
023. 
024. 
025. 
026. 
027. 
028. 
029. 
030. 
031. 
032. 
033. 
034. 


Language: Python 
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import random 


questions = ["As You Like It", "The Tempest", 

"Measure for Measure", “Much Ado About Nothing", 

"The Comedy of Errors", "King Lear", "Cymbeline", 
"Hamlet", "Coriolanus", "Othello","Love's Labour's Lost", 
"King John", "Julius Caesar", "Edward III"] 


chosen phrase - random.choice(questions) 
chosen phrase = chosen phrase.upper() 


vowels = ["A", "E", "I", "О", "U", " ", mind 
puzzle - "" 


for letter in chosen phrase: 
if pot letter in vowels: 
puzzle += letter 


puzzle with spaces - 


while len(puzzle) » e: 
group length - random.randint(1,5) 
puzzle with spaces += puzzle[:group length] + 
puzzle - puzzle[group length:] 


print(puzzle with spaces) 
guess - input("What is your guess? ") 
guess - guess.upper() 


1+ guess == chosen phrase: 
print("That's correct!") 
else: 
print("No. The answer is 


, chosen phrase) 
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| You'll Need 


» 4x LEDs (ideally 
different colours) 


> 4 x 330Q resistors 


> 4х 6mm Tactile 
momentary 
button switches 


> 400-point 
breadboard 


> 9 x Male-to-female 
jumper cables 


> 8 x Male-to-male 
jumper cables 


> PiBow case with 
Breadboard Base 
pimoroni.com 


ne of the best things about the Raspberry Pi is 
that you can easily hook up your own electronics 
projects. Using some electronics components and 


the GPIO Zero library, you can program a puzzle game 
where you have to repeat a sequence of lights that 
gets longer each turn. You might remember a similar 
electronic game from your childhood, but we call ours 
Simple Brian. In issue 77 (magpi.cc/77) we showed 
you how to use Python code to play the game on 


screen. This issue, well show you how to make the 


electronic game itself, building on your new-found 


Python skills from Missing Vowels. 
First, we're going to show you how to build a 
torch by lighting up LEDs. Let's get going. 


Connect your first button 
The torch circuit diagram (Figure 1) 
shows an LED light connected to the GPIO 


(see magpi.cc/breadboard for a primer 
on using this piece of equipment). 
Press the button into the board, 
then use jumper wires to form a 
circuit with your Pi, as shown by 


The online documentation for GPIO Zero 
(magpi.cc/DPyuYc) provides more code 
examples, including a button-controlled camera, 
an LED bar graph, and a motion sensor. We 
surveyed useful resources for basic electronics 

in issue 77, and there's a book in our Essentials 

series called Simple Electronics with GPIO Zero 

(magpi.cc/ gpio-zero). 


pins of a Raspberry Pi using a breadboard 


Build an LED torch 
and electronic game 


Discover how easy it can be to get lights blinking and buttons clicking using 
GPIO Zero and use your new-found skills to build an electronic game 


the yellow wires in the diagram. The first button 
connects to the GPIO 2 pin on one side, and to 
the ground rail on the other side. We'll connect 
the latter to a ground pin on the Pi, so anything 
plugged in that row of holes connects to ground. 


Connect your first LED 

Always use a resistor when you connect an 
LED to your Pi, to prevent the LED drawing too 
much current and getting damaged. Both the LED 
and the resistor plug straight into your breadboard. 
The current flows from GPIO 18, through the 
resistor, through the LED (lighting it up), to the 
breadboard's ground rail. LEDs only work one way 
around: the short leg is the negative side, which 
you connect to ground. The LED won't light up yet. 


Make an LED torch 

You've made your first circuit! Let's test it 
by coding a torch. The torch.py code shows how to 
use an LED and a button. It imports the relevant 
parts of the GPIO Zero library, then sets up an LED 
called light, connected to GPIO pin 18. The button 
on pin 2 is set up with the name button. The while 
True loop checks whether the button is pressed 
forever. If so, the light is turned on. Otherwise, it's 
turned off. Pay attention to the capitalisation of 
LED and Button when setting them up. 


Add the other buttons and LEDs 
Take a look at Figure 2 (overleaf). It looks 
complex at first, but the other three buttons 
and LEDs are connected in the same way as 


A The finished game, with all the lights lit up for testing 


the first ones, just using different pins on the Pi. 
All the buttons (yellow wires) connect to the Pi's 
inner row of pins, and the LEDs (blue wires) to the 
outermost row. We've separated the components 
in this diagram a bit so it's easier to see how to 
wire it up, but try to line up your LEDs and buttons 
on the breadboard so it's easier to play the game. 


Test them all 

Now you can test these LEDs and buttons 
too. Modify your torch code to use LED(23) and 
Button(3) and then run the program to test the 
next light switch works. Then check LED(24) and 
Button(4), and finally LED(25) and Button(17). The 
buttons should be next to the LED they illuminate. 


Build an electronic game 

Now we're ready to start making the Simple 
Brian game (see brian.py). This starts by setting up 
a list of buttons, and a list of their associated LEDs. 
It also creates an empty list called sequence, which 
we'll use for the sequence of lights the player must 
repeat. With each turn, it'll get longer. 


Add functions 

Functions enable you to bundle up a set of 
instructions so you can reuse them. You have to 
define a function before you can use it. To define 
a function, you use def, followed by the function 
name, (), and a colon. The brackets are there to hold 
any info you're sending to the function, but we don't 
need to send any so they're empty. You can tell 
which instructions belong to a function, as they're 
indented. The lights on() and lights off() 
functions use a loop to go through all the items in 
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torch.py 


CSI (CAMERA) 
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xe asn 
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x2 asn 


Count the pins to see where to connect 
your wires 


The breadboard makes it easy to plug in 
components and quickly set up circuits 


Using this simple circuit (with an LED anda 
button), you can make a push-button torch 


Language: Python 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 


# Torch demo 
from gpiozero import Button, LED 


light = LED(18) 
button = Button(2) 


while True: 
if button.is_pressed: 
light.on() 
else: 
light.off() 
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Just like its famous namesake, our Simple Brian 
game features four LED lights that flash up a 
sequence for you to memorise 


o2 The circuit also contains four buttons. We'll 
push these to repeat the sequence of lights that 
we've memorised 


оз At the heart of our project is the Raspberry Pi. 
The buttons and lights are connected to our 
computer with wires. Code in the computer 
flashes the lights and keeps an eye on the 
buttons we're pushing 


А Ona breadboard, the rails along the 
edges are connected in a long line, 
and the short lines of dots in the 

middle are connected to each other 


the leds list, putting them into led, then turning 
led on or off. The flash all() function shows how 
to repeat a set number of times, in this case 3. The 
loop turns the lights on and off, with a 0.25 second 
pause after each change using sleep(@.25). 


Lights test flash all 

After you've entered the functions (down 
to line 23), you can test the program by adding 
flash all()as the last line and then running it. 
All the lights should flash together, three times. 
Delete that test line before you carry on. In line 
25, the program runs the lights off() function to 
ensure the lights are all off before the game begins. 


Add to the sequence 

Now we enter the main game loop, under 
while True (line 27). Everything from here on in is 
indented to show it belongs to that loop, repeating 
endlessly. The game sequence starts as an empty 
list, so the first thing we do is to add an LED. We 
pick a random LED using random. choice() and 
add it to the end of the sequence list using the 
append() list method. A list method is a built-in 
Python function that you can apply to a list. Other 
methods are available to insert and remove items, 
and sort the list, among other things. 


Play the list sequence 

The lights all flash three times using the 
flash all() function before the sequence begins, 
to show this is the start of the sequence. Then a 
loop is used that takes each LED from the sequence 
list, and puts it into light, in turn. It's turned on, 
there's a short pause, then it's turned off. There's 
another short pause so it's obvious there are 
multiple flashes of the same light if it repeats in the 
sequence. In round one, there's only one light in 
the sequence list, but as the game progresses, this 
loop will get longer. You can run the program at this 
point to see the light sequence gradually extend, 
without the player getting a chance to guess. 


Get the player's guess 
Getting the player's guess uses a similar 
loop to the one that plays the lights sequence. It 
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brian.py 


Language: Python 


008. sequence - [] 


magpi.cc/github82 


001. from gpiozero import Button, LED 034. 

002. from time import sleep 035. # play the sequence 

003. import random 036. for light in sequence: 

004. 037. light.on() 

005. buttons = [Button(2), Button(3), Button(4), 038. sleep(@.5) 
Button(17) ] 039. light.off() 

006. leds = [LED(18), LED(23), LED(24), LED(25)] 040. sleep(0.25) 


042. + get the player's input 


009. 043. for light in sequence: 

010. def lights on(): 044. guess - None 

011. for led in leds: 045. while guess -- None: 

012. led.on() 046. for button in buttons: 

013. 047. if button.is pressed: 
014. def lights off(): 048. # convert button push to list 
015. for led in leds: index number 

016. led.off() 049. guess - buttons.index(button) 
017. 050. 

018. def flash all(): 051. if leds[guess] == light: 

019. for _ in range(3): 052. light.on() 

020. lights on() 053. sleep(0.5) 

021. sleep(0.25) 054. light.off() 

022. lights off() 055. sleep(0.25) 

023. sleep(0.25) 056. else: 

024. 057. print("You failed at level ", 
025. lights off() len(sequence)) 

026. 058. for _ іп range(10): 

027. while True: 059. light.on() 

028. # Add a new light to the end of the sequence 060. sleep(0.15) 

029. new light - random.choice(leds) 061. light.off() 

өзе. sequence.append(new light) 062. sleep(0.15) 

031. 063. sequence - [] 

032. # Flash all before playback 064. break 

033. flash all() 


works its way through the sequence list, accepts a 
guess, and checks whether it matches the current 
item in the sequence. There are three loops inside 
each other here. The program sets the guess 
variable to None, a special value in Python. Then 

a while loop keeps repeating until the guess 
variable changes. Inside that, a loop goes through 
the buttons list, checking each one in turn to see 
whether it's pressed. If so, the guess variable is 
changed, ending the while loop. The program 
converts the button the player pressed into its 
index number in the list and puts that into the 
guess variable. That way, we can match the button 
to its LED, which will be at the same position in the 
leds list. You can find the position of an item ina 
list using listname.index(item). 


Check the player's guess 

We're still inside the loop going through 
the sequence here, as the indentation of line 51 
shows. Now we check whether the light the player 
guessed (leds [guess ]) matches the current light in 
the sequence. If so, the light is turned on and then 
off again. If the two lights don't match, the player 
made a mistake. We can tell how long a list is using 
len(listname). We use the length of the sequence 
list to tell the player which level they got to. The 
correct light is then flashed quickly ten times. The 
sequence list is emptied to start a new game, and the 
break instruction breaks out of the for loop that's 
getting player input. When the player has either 
guessed all the lights, or failed, the game repeats 
from line 28, adding a new light to the sequence. M 


TopTip è 


Underscoring 
repetition 


The line for _ in 
range(3) repeats 
the indented 
instructions three 
times. The . 
shows we don't 
need to use the 
loop number. 
Often, you'd 

use a variable 
name instead. 
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The Pi Zero's size means 
it's a comfortable 
addition to a keyring 


Evans 


PJ is a writer, 
Jammer, and loves 
vintage computing. 
He is never more 
than five metres 
away from a 
Raspberry Pi. 


@mrpjevans 


Pi keyring 


You can still access the 
microSD card so your Pi 
can be multi-purpose 


Need a Raspberry Pi in your grab-bag? Here's how you can get 
a Pi up and running and networked just about anywhere 


for its diminutive nature, the need for 

a keyboard, mouse, and monitor can 
somewhat spoil the portability. If you've ever 
had a moment thinking, “If only I had a Raspberry 
Pi with me right now", this is the project for you. 
More than just a Pi-in-a- pocket, we're going to 
create a travel-ready Pi, free of peripherals but 
with full desktop support, that can join the local 
network either via its own WiFi hotspot, ога 
hidden feature of Raspbian: USB networking. 


A Ithough our beloved Pi is rightly praised 


Prepare the Pi 

Even though our portable Pi will not require 
a keyboard, monitor or mouse (well, sort of, you'll 
see), we want to get the most out of the device, 
so start by getting the full ‘Raspbian Stretch with 
desktop and recommended software’ image from 
the Raspberry Pi website (rpf.io/raspbian). Write 
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it to a microSD card using your favourite utility 
(we used balena Etcher - balena.io/etcher). 
However, just to show that it's possible to do all 
this without ever hooking the Pi up to a monitor, 
don't boot up just yet. 


Set up for headless 

Reinsert the microSD card into your 
computer. It will mount a drive called ‘boot’. We're 
going to make some changes so the Pi starts with 
both WiFi and USB networking enabled. That's 
right, Raspbian has a feature that allows it to act 
like a network device to any computer connected 
by USB. Simply connect the Pi to your computer 
with a USB cable and a private network is set up 
between them, giving headless access without 
needing to get the Pi on the network. It's not 
enabled by default, so we'll make some changes to 
files in the boot directory to fix this. 


": E. P 2 
ае: 40 еее ше 


A The pre-installed VNC server streams the Pi's desktop user 
interface to any other computer on the network 


Enable WiFi and SSH 

In the boot directory, create a file called ssh, 
with no extension. It doesn't need any content. On 
UNIX-style systems, you can enter: 


touch ssh 


Now, using a text editor, create a file in the same 
directory called wpa_supplicant.conf and enter 
the following (change country code if appropriate): 


country-gb 
update config-1 
ctrl interface-/var/run/wpa supplicant 


network={ 

scan_ssid=1 

ssid="Your network name" 
psk="Your network password" 


} 


Replace the values of ssid and psk to match your 
WiFi network name and password. 


Size matters 

When a Pi boots without a monitor attached 
(headless), the desktop still starts, but at a very 
small screen resolution. We’re going to be using 
VNC to remotely access the desktop, so we need 
to make it a bit more usable. Using a plain- 
text editor, open the file config.txt in the boot 
directory. Be very careful making changes here as 
it can render your Pi unbootable. Scroll down the 
file until you see two lines as follows: 


#framebuffer_width=1280 
#framebuffer_height=720 


m We're going to create a 
travel-ready Pi, free of 
peripherals but with full 
desktop support Ei 


Note the ‘#’ before them; this marks them as 
comments and so they are ignored. Remove the '1? 
so it looks like this: 


framebuffer width-1280 
framebuffer height-720 


Enable USB networking 
Scroll down to the bottom of the config.txt 
file and add the following line: 


dtoverlay=dwc2 


This instructs Raspbian to apply the USB 
networking module. Save and close config.txt. 
To make sure the module is made available, edit 
the file cmdline.txt, also in the boot directory. 
The contents of the file are on a single line. Find 
the end of the line and, making sure you do not 
add a new line in the process, add a single space 
followed by: 


modules-load=dwc2,g ether 


Now save and close cmdline.txt, then eject the 
microSD card. 
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| You'll Need 


» micro USB to USB 
cable 


» LiPo SHIM 
(optional) 
magpi.cc/zaMZab 


» LiPo battery 
(optional) 
magpi.cc/FOuZmb 


» Keyring case 
magpi.cc/hqjqdE 


У Pimoroni's LiPo SHIM 
allows safe use of a 
LiPo battery without 
blocking GPIO ports 
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TopTip ё 
| Easy WiFi 


USB networking 
gives you a 
reliable method of 
setting up the Pi's 
» WiFi connection if 
{| you want to give 

| others access. 
к 


Y Using a 3D printer, 
you can customise 
and create your 
own case 
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o 6| Connect via USB 

Ман It's time to wake up our Pi. Insert the 
microSD card into the Pi and connect a micro 
USB cable to the peripheral USB port on the Pi 
Zero, not the usual power USB port. If you're 
unsure, the peripheral port is the one nearest the 
mini-HDMI connector. We need full USB access 
for networking, and your computer will also 
supply enough power to keep the Zero happy. 
Connect the cable to your computer and wait a few 
minutes so Raspbian has time to resize the file 
system and set things up. 


= i 

07 Esc | 

ш From the command line (users of 
Windows 8 or before may need to install PuTTY), 
run these commands: 


ssh-keygen -R raspberrypi.local 
ssh piQgraspberrypi.local 


The first command cleans out any previous SSH 
keys you may have for raspberrypi.local. You do 
not need to run it again. Hopefully you'll now be 
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prompted for a password. Enter raspberry and 
you're in. If you find you can't connect to the 

Pi, re-examine the changes you've made to the 
boot directory or try booting with a monitor and 
keyboard. You may connect through WiFi rather 
than USB. Run ifconfig at the Pi's command line 
to see the different networks. 


08 08 Configuration 

We've established we have headless access 
to the Pi Zero. While you are logged in, start with 
some housekeeping. Run this command: 


sudo raspi-config 


Firstly, change your password from raspberry to 
something harder to guess. Now go to ‘Network 
Options’ then ‘Hostname’. Here you can rename 
your Pi to something else if you wish, reducing the 
risk of it clashing with another Pi on the network. 

Finally, go to ‘Interfacing Options’ and enable 
the VNC server. This will allow you to stream the 
desktop to another device. Reboot the Pi now so 
the host name change takes effect. 


uw» 
ve 


A If you need GPIO access, the official case is perfect with its 
selection of covers. Make two small holes for a thread loop 


Desktop access 

To stream the Pi desktop, you'll need a 
client for your connected computer. A popular 
choice is VNC Viewer, available for a wide range of 
platforms from magpi.cc/FuGnye. Once installed, 
enter your Pi’s new host name followed by ‘.local’ 
as the server and press ENTER. In a few seconds, 
the desktop will appear on your screen. 

You should see a ‘Welcome to Raspberry Pi’ 
dialog box. Now's the time to go through these 
menus and also update the current software 
when prompted. The Pi will need a working WiFi 
connection to do this. 


Hotspot access 

If you want a truly standalone experience, 
and internet connectivity isn't a concern, another 
connection option is to use the Zero's WiFi 
capability and create a hotspot. Then, no matter 
where you are, so long as you can get power to the 
Pi, any computer will be able to connect and SSH 
or VNC in. 

Setting up a hotspot doesn't take long, but 

does involve several steps, including setting 
up a DHCP server and hostapd. Take a look at 
magpi.cc/BRdGKK for a comprehensive guide. 
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m To stream the Pi desktop, you'll need a 
client for your connected computer. A 


popular choice is VNC Viewer Л 


Batteries are included? 

If you are taking the hotspot route, why not 
go the whole nine yards and add battery power? A 
Zero will run quite happily for hours from widely 
available USB power banks. If you're feeling fancy, 
why not add in a LiPo battery so you have a single 
self-contained unit? LiPo batteries come with 
safety concerns (see ‘LiPo safety’ box), so we need 
some circuitry to manage the battery and make 
sure it supplies the correct voltage. Pimoroni's 
LiPo SHIM does just this with the added bonus 
of not using up any of your valuable GPIO ports. 
Carefully solder it to the base of the GPIO pins and 
you've got power. Don't forget to add a switch. 


A Always be careful 


editing the files in 
the boot folder. Take 
backups and use 

a text-only editor 
like nano 


Print a case 

Obviously, we can't leave our little Zero 
unprotected, so our final step is to provide a nice 
case. If you're wanting to use GPIO, the official case 
can be adapted to accept a keyring with a small 
drill bit and a steady hand. If you've added battery 
power, it may be time to get a CAD package out and 
design something that fits everything into one. 
We opted for a 3D- printed case (magpi.cc/hqjqdE) 
from Thingiverse maker Haunt Freaks, which 
features a ready-to-go hoop to accept a keyring or 
lanyard clip. Wl 


TopTip & 


Add a NAT 
gateway 


You can configure 
the connected 
computer to 
route internet 
traffic to and 

from the Pi using 
network address 
translation (NAT) 
routing software. 


A Pi Zero without 

headers means an 
extra slimline case 
with no pointy bits 
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Rob 
Zwetsloot 


Rob is amazing. 
He's also the 
Features Editor 

of The MagPi, a 
hobbyist maker, 
cosplayer, comic 
book writer, and 
extremely modest. 
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| You'll Need 


» NeoPixel lights 

» Circuit wire 

» Push-button 

» 470 Q resistor 

» 5V power source 


» Soldering iron 


NeoPixel display 
cabinet lights 


Light up a display cabinet with some NeoPixels, a Raspberry 


Pi, and a little Python code 


e've covered NeoPixels in The MagPi 
W before, with some wonderful cosplay 

lights (magpi.cc/45) and Christmas 
tree lights (magpi.cc/52), which we’ve used 
ourselves. It’s been a long time since we’ve 
controlled any NeoPixels with a Raspberry Pi, 
though - so long that there's actually a newer and 
much easier method for doing it. 

We thought it was high time to try this out, and 

get a display cabinet lit up fancily in the process. 


to create a little semicircle in our cabinet for a bit 
more interesting coverage. 

If you have a big cabinet and wish to line the 
entire thing, you can always get a long flexible 
strip of NeoPixels. You can even get single lights, 
or smaller circles of NeoPixels. 

The only thing you need to make sure you do 
for all the NeoPixel types is correctly count the 
number of LEDs in your system. We'll tell you why 
in a few steps’ time. 


Choose your NeoPixels 

There are many configurations and types 
of NeoPixels that you can buy. For our display 
cabinet, we chose two quarter-circle stripes of 
lights that hold 15 LEDs a piece. This allowed us 


A Figure 1 This diagram shows 
the rough circuit for our 
setup, and should be used as 
a guide for your own 
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Choose a location 

What do you want to light up? For our 
project, a shelf of figurines was all we wanted to 
illuminate, and so we decided to add the lights 
above the shelf – attached to the ‘ceiling’, as 
it were. 

You'll need to take into consideration light 
coverage and camouflage in your display cabinet. 
Think about sight lines if you want to keep them 
hidden from specific angles, and look to see if your 
display cabinet has anything to aid in adding lights 
- the IKEA Detolf has a little plug on the top for 
wires, for example. 

There also needs to be access for the Pi to 
control the lights, so keep that in mind. 


Assemble your circuit 

We've put together a handy circuit diagram 
(Figure 1) for you to follow along to. There are a few 
important things to note, though, to make sure you 
understand it. 

The NeoPixel strips have three pads on them: 

one for 5V power, one for ground, and a ‘data’ 
port. The data needs to be connected to the GPIO 


Using the Raspberry Pi, we 
can easily control a strip of 
multicoloured NeoPixel LEDs 


pin we're sending the signals from. You also need 
to make sure to connect it to the Din (data in) pad. 
If you're chaining together strips like we've done, 
make sure you connect the Dout (data out) from 
the first strip to the Din of the next strip. It's also 
good practice for ground on the NeoPixels to go to 
the Raspberry Pi's ground, as well as the ground of 
the power source. 

We've placed the button way down the GPIO 
pins to keep it clear. You need the resistor in the 
little button circuit to make sure it works properly 
and can be sensed by the Raspberry Pi. 


Soldering the NeoPixels 

This bit can be tricky, but you will have to 
solder some wires to your NeoPixel strips. Make 
sure your soldering iron is properly prepared if 
this is your first time using it (check this video: 
magpi.cc/GCUNyL). Also, if this is your first time 
soldering, check out the Raspberry Pi Foundation's 
video on it: magpi.cc/Ahvxdk. 

We recommend putting a little solder on your 
wire (this is called tinning it), as well as a dab on 
the pads. That way, you just need to heat up the 
solder already on the wire and pad so that they fuse 
and connect. 


Powering the system 
You need to power two parts of your light 
display: the Raspberry Pi and the NeoPixels. The 
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The NeoPixels are 
programmable LEDs 
that can display any RGB 
colour that you choose 


RGB colour 


Red, green, 

and blue lights 
make up a single 
NeoPixel. Using 
a value of each 
colour between 
О and 255, you 
can create an 
entire rainbow 
of colours. 


m You need to power two parts of 
your light display: the Raspberry Pi 
and the NeoPixels Л 


NeoPixels require a 5 V input, and also draw a lot of 
power at the same time; so, to be safe, you really 
shouldn't power more than two or three NeoPixels 
with the 5V pin of the Raspberry Pi. In our circuit, 
we've used four 1.5 V AA rechargeable batteries, as 
they're technically closer to about 1.2V each - that 
means we get roughly 5V out of them. 

A more convenient way is to get a 5 V power 
supply and use a power terminal with two screw 
ports to attach the positive and negative ends. 
Please make sure the power supply is unplugged 
while you do this, and be very careful when 
plugging it in. 

You can technically run a Pi using the GPIO pins; 
however, we have elected to run a micro USB cable 
up to our Pi. 


Basic code 

We've written the code, rollcall.py, to 
work with our specific system. Download it from 
magpi.cc/DisplayLights апа we'll run through it. 

First, we import the generic stuff: time, 

gpiozero, as well as the neopixel library and its 
related board library. We've also used the numpy 
library so that we can create RGB values for the 
LEDs, which enables them to fade between colours. 
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P We used Blu Tack to 
attach the lights to 
the top of our cabinet 


TopTip è 


Roll call 


The six colours 
chosen represent 
the main team 
of figurines in 
the cabinet - 
it's a tradition 

in Japanese 
superhero TV 
shows to run 
down your name 
and colour in a 
specific order. 


Our system uses 30 LEDs, and we've connected 
it to GPIO 18 on the board. We've then defined six 
colours that represent the figurines in the display 
for our added colour cycle effect. After that, we tell 
the code about the strip of NeoPixels. 

We then define how to calculate the values 
for colour fading, and the colours to transition 
between, before turning the strip of LEDs to pure 
white. Finally, we set the main rollcall cycle 
function to loop, so we can press the button 
whenever we want. 


07 Alter your code 
The main parts of the code to pay attention 

to are the LED_COUNT, LED_PIN, and button values. 
Your number of LEDs will likely differ from ours, 
and you may have connected the strip and button 
to different GPIO pins. 

As for the colour cycle, play around with that 
to your heart’s content, or remove it completely! 
You can even change the main colour value for the 
standard lights, using RGB values from 0 to 255. 


Testing your lights 

Before attaching everything to your cabinet, 
we highly recommend testing your LEDs. Run the 
code from within your preferred Python IDE, and 
make sure that not only are you getting the correct 
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colours (you may have a GRB set of NeoPixels 
instead of RGB, for example), but that also the 
button works. 


Final Pi prep 

The Raspberry Pi in our setup is going to be 
headless, which means we want the Python code to 
load up after the Pi turns on. Our preferred method of 
doing this is adding a line to /etc/profile — it makes it 
a lot easier. Open up a Terminal window and type: 


sudo nano /etc/profile 
Use the arrow key to go to the bottom, then add: 
sudo python rollcall.py 


If you’ve saved the Python script to a specific 
folder other than the home directory, make sure 
to include the path to it as well. Save and exit the 
file. You can also turn off ‘boot to desktop’ in the 
Raspberry Pi configuration settings, so that the 
entire system loads up faster. 


Mounting the lights 

Depending on your NeoPixels, you can 
attach them in several different ways. We’ve used 
Blu Tack to stick ours to the ceiling of our display 
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rollcall.py 


DOWNLOAD 
THE FULL CODE: 


» Language: Python 


© magpi.cc/DisplayLights 


001. #!/usr/bin/env python 030. colour2 = np.array(colour2) 
002. 031. vector = colour2-colour1 
003. import time 032. newcolour = (int((colour1 + vector*percent) 
004. [@]), int((colouri + vector * percent)[1]), 
005. from gpiozero import Button int((colour1 + vector * percent)[2])) 
006. 033. return newcolour 
007. import board 034. 
008. import neopixel 035. # Create a function that will cycle through the 
009. import numpy as np colours selected above 
010. 036. 
011. button - Button(21) 037. def rollcall cycle(wait): 
012. 038. for j in range(len(gokai colours)): 
013. # LED strip configuration: 039. for i in range(10): 
014. LED COUNT  - 30 # Number of LED pixels. 040. color1 = gokai_colours[j] 
015. LED PIN - board.D18 # GPIO pin 041. if j == 5: 
016. LED BRIGHTNESS = 0.2 # LED brightness 042. color2 - (255,255,255) 
017. LED ORDER = neopixel.GRB # order of LED colours. 043. else: 
May also be RGB, GRBW, or RGBW 044. color2 = gokai_colours[(j+1)] 
018. 045. percent = i*0.1 # 0.1*100 so 10% 
019. # The colour selection selected for this increments between colours 
project: red, blue, yellow, green, pink, and 046. strip.fill((fade(colour1,colour2, 
silver respectively percent))) 
020. 047. strip.show() 
021. gokai colours = [(255,0,0),(0,0,255),(255,255,0) 048. time.sleep(wait) 
,(0,255,0), (255,105,180), (192,192,192) ] 049. 
022. 050. strip.fill((255,255,255)) 
023. + Create NeoPixel object with appropriate 051. strip.show() 
configuration. 052. 
024. strip - neopixel.NeoPixel(LED PIN, LED COUNT, 053. # Main function loop 
brightness - LED BRIGHTNESS, auto write-False, 054. 
pixel order - LED ORDER) 055. while True: 
025. 056. 
026. # Create a way to fade/transition between 057. time.sleep(1) 
colours using numpy arrays 058. 
027. 059. button.wait for press() 
028. def fade(colour1, colour2, percent): 060. rollcall cycle(0.2) it 0.2 seconds between 
029. colour1 = np.array(colour1) colour updates 


case; however, you could also use glue. For the long 
strips, you can always nail them in with staples so 


that you don’t actually have to go through the strip. 


Just make sure any exposed PCB is not touching 


cables makes the whole thing a lot neater. You can 
also cover any soldered joints with a bit of hot glue. 


anything conductive. 


Have fun and experiment! 

This basic setup can very easily be expanded 
upon. As the Pi is internet-connected, you'll be able 
to use some IoT stuff like Twitter triggers or noise 
activation or temperature-dependent colouration. 
You can even add more strips to the Pi so that you 
can have several layers of lighting effects. We hope 
this really improves your display cabinets. ll 


Permanent circuit tips 

You don't really want exposed wires 
everywhere just to light up your display case. 
Creating a 3D case to house the Pi is a good first 
step, and using heat-shrink tubing to encase all the 
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Mike 
Cook 


Veteran magazine 
author from the old 
days, writer of the 
Body Build series, 
plus co-author of 
Raspberry Pi for 
Dummies, Raspberry 
Pi Projects, 

and Raspberry 

Pi Projects 

for Dummies. 


magpi.cc/TPaUfT 


| You'll Need 


» Lego 17101 Boost 
Creative Toolbox 
magpi.cc/JtUiDe 


» USB MIDI lead 
magpi.cc/fZiGvF 


» MIDI sound 
generator 


» Optional cardboard 
and paint 


Hack Lego Boost. 
with Raspberry P1 


Make a MIDI sequence generator that creates sequences 


from our small mobile rover: Si-clops 


projects where we explored the finer points 

of control that are normally hidden from 
you by the standard Lego software. In this final 
part (at least for now), we will look at making a 
MIDI sequence generator that creates sequences 
by letting a small mobile rover loose over any flat 
surface, as we introduce you to Si-clops. 

Figure 1 shows Simon; he's always asking 
people about colours. However, this month the 
one-eyed Simon rides his colour-sensing Si-clops 
to generate music sequences from what it sees. 
This can be by roaming over existing artwork or 
scanning a set of coloured tiles placed in a tile 
holder. The sound is generated from a MIDI sound 
module attached to the Raspberry Pi with a USB 
MIDI lead. Once playing, the sequencer turns each 


[ ast month we looked at three example 


от... a 
This part is the 
Boost's colour sensor 
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colour into a note of settable pitch, velocity, and 
instrument at a rate determined by the tempo 
parameter. The sound from each colour can also be 
individually muted. 


The theory 

The Boost system can recognise six different 
colours and if we have a sequence of eight steps in 
length, we get an enormous number of possible 
sequences. In fact, the number of possible sequences 
is six (the number of different colours we have in 
each place) raised to the power of eight (the number 
of steps that make up our sequence). Which, in 
terms of hard numbers, is 65, giving a total of 
1,679,616 different possible combinations. As we 


Figure 1 


Press to connect 
and to create a 
sampling scan 


A Figure 1 Meet 
Simon, or Si for short 


Si-clops.py 
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» Language: Python 3 


DOWNLOAD 
THE FULL CODE: 


© magpi.cc/dhaAam 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 
014. 


015. 
016. 
017. 


018. 
019. 
020. 


021. 


022. 
023. 


024. 


025. 


026. 


027. 
028. 
029. 
030. 


031. 
032. 


033. 
034. 
035. 
036. 
037. 
038. 
039. 


040. 


041. 


042. 
043. 


#!/usr/bin/env python3 

+ coding=utf-8 

# Siclops Colour Sequencer 
# By Mike Cook April 2019 


import time, pygame, os 

from pylgbst import * 

from pylgbst.movehub import MoveHub, COLORS 
from pylgbst.peripherals import EncodedMotor 
import rtmidi 


midiout = rtmidi.MidiOut() 

pygame. init() 

pygame.display.set_caption( 

"Si-clops -> Colour Sequencer") 
os.environ['SDL VIDEO WINDOW POS'] = 'center' 
pygame.event.set allowed(None) 

pygame.event.set allowed([pygame.KEYDOWN, pygame. 
QUIT, pygame .MOUSEBUTTONDOWN, pygame . MOUSEBUTTONUP ] ) 
screenWidth = 430 ; screenHight = 400 

cp - screenWidth // 2 

Screen - pygame.display.set mode([screenWidth, 
screenHight],0,32) 

textHeight-18 ; font - pygame.font.Font(None, 
textHeight) 


samples = 8 ; step = 0 ; midiStep = 0 ; newScan = 

False ; motorUpdate - True 

backCol - (160,160,160) ; lineCol - 

hiCol - (0,255,255) 

tileColours = [ (0,0,0), backCol, (0,9,0), 

(0,0,255), (128,128,255), (0,255,255), 
(0,255,0), (255,255,0), 

(255,128,0), (255,0,0), (255,255,255)] 


(128,128,0) ; 


scannedBlock - [3,10,9,0,7,6,9,10] 
colourToTrack - [5,-1,-1,0,-1,-1,1,2,-1,3,4] 
chan - [1]*6 ; velocity - [64]*6 ; mute - 
[False]*6 

note = [56+i for i in range(0,6)] 

lastNote = [0] * samples ; lastChan = 

[-1] * samples 

shutDown = False ; update = False 

nextStep = time.time() ; tempo = 200 # BPM 
running = False # MIDI sequencer 
lastColour = 255 ; updateColour = 0 
tileDistance = 0.0 ; currentMotor = @ 


noteNames = ["C","C#","D","D#","E","F","F#","G", 
"Git" , "A" "Ait" ,"B"] 
instNames = ["Piano","Harpsichord","Glockenspiel", 
"Marimba", "Bells", "Organ", "Guitar", 
"Bass","Timpani","Percussion","Alto Sax", 
"Clarinet","Rain", "Goblins", 
"Banjo","Tinkle Bell"] 


insNums - [0,6,9,12,14,19,27,32,47,52,65,71,96, 


044. 
045. 
046. 


047. 
048. 
049. 
050. 
051. 
052. 
053. 
054. 
055. 


056. 
057. 
058. 
059. 
060. 
061. 
062. 
063. 
064. 
065. 
066. 
067. 
068. 
069. 


070. 
071. 
072. 


073. 
074. 
075. 


076. 
077. 
078. 
079. 
080. 
081. 
082. 
083. 
084. 
085. 
086. 


087. 
088. 
089. 
090. 
091. 


101,105,112] # to match above 


def main(): 
global update,movehub, shutDown, step, 
currentMotor, conn 
print("Si-clops - Colour sensor sequencer") 
print("press the green button now") 
conn-get connection auto() 
print("Looking for Hub") 
movehub - MoveHub(conn) 
print("Hub connected") 
init() 
initMIDI() 
print( 
"Initialised - Press green button to scan") 
drawScreen() 
while not shutDown: 
checkForEvent() 
if newScan: 
sensorScan() 
if time.time() > nextStep: 
doMIDIstep() 


def doMIDIstep(): 
global nextStep, midiStep, lastNote, lastChan 
if not running: 
time.sleep(0.1) # yield for other programs 
return 
tileNumber - colourToTrack[ 
scannedBlock[midiStep]] 
#turn off the note you are about to play 
if lastChan[midiStep] !- -1: 
midiout.send message([0x90 | lastChan[ 
midiStep],lastNote[midiStep],9]) 


if not mute[tileNumber]: 
midiout.send message([0x90 + 
chan[tileNumber]-1i,note[tileNumber], velocity[ 
tileNumber]]) 
lastNote[midiStep]- note[tileNumber] 
lastChan[midiStep]- chan[tileNumber]-1 
nextStep = time.time() + stepTime 
updateSamples(midiStep) 
midiStep += 1 
if midiStep >= samples: 
midiStep =0 


def allOff(): 
for i in range(0,16): 
midiout.send message([OxBO | i,120,0]) 
# normally only one is needed 
midiout.send message([0xBO | i,123,0]) 


def sensorScan(): 
global step,currentMotor, newScan 
allOff() # turn off any sound 
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A Figure 2 How to 
tidy up the colour 
sensor's wire 


TopTip è 


Aligning 
Si-clops 


We drew a white 
square round 

the end of the 
sample tile holder 
to allow us to set 
Si-clops in exactly 
the right place. 

If you shade 
external light 

with your hand, 
you can see the 
illuminated area 
the colour sensor 
uses to detect 

the colour. 


P Figure 3 The 
sequencer 
control panel 


Figure 2 


found last month, the optimum distance for working 
with the colour sensor is 10mm, so the Si-clops is 
designed to get as close as possible to this distance. 


The practice 

The construction of the Si-clops is simple 
enough, and could be guessed from the pictures 
we show here. However, a step-by-step guide 
to building Si-clops is on the GitHub page 
(magpi.cc/dhaAam). All the parts are from the 
Boost set, so you'll have them to hand. However, the 
Studio modelling program does not handle flexible 
parts, so Figure 2 shows you how to wrap the cable 
from the colour sensor to Port C of the Boost Hub. 
It's best to plug the colour sensor's wire into the 
Hub and then temporarily remove the Lego brackets 
and push the cable behind and then replace them. 


What the code needs to do 

We need the Python controlling code to 
instruct the Boost's Hub to move the two built-in 
motors through eight short steps, stopping at the 
end of each step to send back a colour sample. This 
sampling can be controlled through an on-screen 
button or by pushing the Hub's green button. Then 
this sequence is displayed and a click of the Run 
button starts things going. The exact note pitches, 
velocities, and channel/instrument are controlled 
by mouse clicks, as are the tempo and the channel 
mute. The code is written under the Pygame 
framework and is shown in the Si-clops.py listing. 


Icons 
The program needs a directory called icons; 
in it, there needs to be two 15x15 pixel images on a 
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transparent background, called 0.png and 1.png. 
The o.png image is a green plus sign, and the 1.png 
image is a red minus sign; both can be made with 
any paint package, such as GIMP. Figure 3 shows 
the layout of the screen; the whole user interface 

is based on Pygame's rectangle data structure, 
rect. Rectangles are defined for each user control, 
and the mouse down and up events change the 
appropriate numbers. This results in easy-to- 
modify, efficient code. 


Code in depth 

The insNums list holds the instrument 
number associated with each MIDI channel, with 
the instNames list showing the names. You can 
change these if you would like to use a different 
set of instruments. Each instrument potentially 
sounds for the full length of the sequence, the 
note-off message only being sent just before the 
note-on message. If a colour appears more than 
once in the sequence, then the note-off message is 
sent whenever that colour is encountered. A brown 
square in the middle of a sample colour indicates 
that it is the one currently being played. 


Customising the code 

All GUI colours are defined by variables, so 
they are easy to change. The motor moves by the 
number of degrees defined by the inc variable in 
the incMotor function for each step. The original 
code is set so that Si-clops moves 20 mm per step; 
you can change this to whatever you want if you 


Si-clops -» Colour Sequencer Figure 3 
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Si- 


clops.py (continued) 


092. 
093. 
094. 
095. 
096. 
097. 
098. 
099. 


100. 
101. 
102. 
103. 
104. 
105. 


106. 
107. 
108. 
109. 
110. 
111. 
112. 
113. 
114. 
115. 
116. 
117. 
118. 
119. 
120. 
121. 
122. 
123. 
124. 
125. 
126. 


127. 
128. 
129. 
130. 


131. 


132. 
133. 
134. 


135. 
136. 
137. 
138. 
139. 
140. 


for i in range(@,samples): 
scannedBlock[i] = 1 # background colour 
incMotor() # to move before first sample 
step = 0 
while step < samples: 
checkForEvent() 
getCol() 
movehub.motor AB.angled(-currentMotor, 
back to start 
newScan - False 
updateValues() 
step = 0 ; currentMotor = @ 


.4) + 


def getCol(): 
global lastColour, updateColour, motorUpdate, 
scannedBlock, shutDown 
if updateColour >= 2 and motorUpdate: 
# put in the index of the colour 
scannedBlock[step] = correctColour(lastColour) 
updateSamples(-1) 
updateColour = @ 
motorUpdate = True 
incMotor() 
else: 
updateColour = 0 


def initMIDI(): 
global midiout 
available_ports = midiout.get_ports() 
print("MIDI ports available:-") 
for i in range(0,len(available ports)): 
print(i,available ports[i]) 
if available ports: 
try: 
midiout.open_port(1) 
except: 
print( 
"No MIDI port found opening virtual port") 
midiout.open_port(@) 
for ch in range(@,16): # set up channels 
if ch != 9: 
midiout.send_message([@xC@|ch, insNums[ch]]) 
# set instrument 
midiout.send_message([@xB@ | ch,0x07,127]) 
# set volume 
setTime() 


def setTime(): # calculates the step time from the 
tempo (BPM) 
global stepTime, tempo 


stepTime = 1/(tempo / 60) 
updateValues() 
def init(): 


global motor, markerRect, shutDown, driveRect, 
incRect, decRect, icon, decRect, muteRect, 
voiceRect, sampleRect, rsRect 


141. 
142. 
143. 


144. 


145. 
146. 
147. 
148. 
149. 
150. 


motor = None 
movehub. button. subscribe(call_button) 
movehub.color distance sensor.subscribe( 
callback colour, granularity=0) 
icon - [pygame.image.load( 
"icons/"4str(i)*".png").convert alpha() 
for i in range(0,2) ] 
incRect = [pygame.Rect((0,0),(15,15))]*20 
decRect - [pygame.Rect((0,0),(15,15))]*20 
for j in range(0,3): 
for i in range(0,6): 
incRect[i+j*6] = pygame.Rect(( 
76 + ј*80,76+1*40), (15,15)) 
decRect[i+j*6] = pygame.Rect(( 
76 + ј*80,96+1*40), (15,15)) 
incRect[18] = pygame.Rect((76,326),(15,15)) 
decRect[18] = pygame.Rect((76, 346), (15,15)) 
incRect[19] = pygame.Rect((116,326),(15,15)) 
decRect[19] = pygame.Rect((116,346),(15,15)) 
driveRect = pygame.Rect((176, 335), (54, 22)) 
rsRect = pygame.Rect( (296,335), (38,22)) 
muteRect = [pygame.Rect((0,0),(15,15))]*6 
voiceRect = [pygame.Rect((0,0),(15,15))]*6 
for i in range(@,6): 
muteRect[i] = pygame.Rect((370,80+i*40), 
(28, 20)) 
voiceRect[i] =pygame.Rect((268,85+i*40), 
(100, 20) ) 
sampleRect = [pygame.Rect((0,0),(15,15))]*8 
for i in range(@,samples): 
sampleRect[i] = pygame.Rect((584i*40,20), 
(20, 20)) 
markerRect = [pygame.Rect((0,0),(15,15))]*8 
for i in range(0,samples): 
markerRect[i] = pygame.Rect((63+i*40,25), 
(10,10)) 
setTime() # calculate MIDI time interval 


def drawScreen(): 
screen.fill(backCol) 
for i in range(0,20): # increment / decrement 
icons 
screen.blit(icon[9],( 
incRect[i].left,incRect[i].top)) 
pygame.draw.rect(screen,lineCol,incRect[i],1) 
screen.blit(icon[1],( 
decRect[i].left,decRect[i].top)) 
pygame.draw.rect(screen, lineCol,decRect[i],1) 


# draw all tiles 

playingToLego = [3,6,7,9,10,0] 

for i in range(@,6): 

pygame.draw.rect(screen, 

tileColours[playingToLego[i]], (10,82+40*i, 20,20),0) 

агамлогаѕ("Ті1е",10,54, (0,0,0), backCol) 

агамлогаѕ( "Сһаппе1" , 58,54, (0,0,0), backCol) 

агамлогаѕ ( "Мосе" 138,54, (0,0,0), backCol) 
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A Figure 4 Sample 
holder and tiles - 
dimensions in mm 


» Figure 5 Si-clops 
and a loaded 
sample holder 
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want to roam over artwork. Si-clops also returns 
to its starting position after the sample scan, but 
you could change that also. By moving the two 
Hub motors by different angles each step, you can 
get Si-clops to move in a curve as opposed to a 
straight line. 


07 Tile sample holder 

While running Si-clops over artwork can be 
fun, it can also be a bit hit and miss. If you want to 
explore sequences with absolute control, you need 
a colour sequence you can set up as you want. So we 
made a sample holder, which is basically just a piece 
of 1mm (or thicker) mounting board, cut out in the 
dimensions shown in Figure 4. A slot is cut out at 


Figure 5 
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TopTip a 


Installing rtmidi 


If you haven't got the Python MIDI library installed, 
open up a Terminal and enter: 


sudo apt-get install libjacke 

sudo apt-get install libjack-dev 
sudo apt-get install build-essential 
apt-get install libasound2-dev 
pip3 install python-rtmidi 


sudo 
sudo 


one side, and we painted round the slot with brown 
paint. We cut out small pieces of card that will slide 
along the slot and painted them different colours. 
Fixing the sample holder to the desk with very small 
pieces of Blu Tack stopped it moving. 


Painting 

We used low-cost acrylic paints from an art 
shop to paint our tiles; there is a 4 mm strip down 
the edge of the tile and we painted it brown. We 
found that brown was a good neutral colour that did 
not affect the detection of adjacent colours. Then we 
painted the main colour in the rest of the tile. For 
a full set of tiles you need eight of each colour, but 
six is enough in practice. Also, the mounting board 
we used had a black back, so there is no need to 
make any black tiles - just simply turn any tile over. 
Figure 5 shows the finished assembly. 


In conclusion 

Well, that wraps it up for our experiments with the 
Lego Boost set. We hope you have enjoyed it. But 
we have hardly scratched the surface - we certainly 
could write a whole book on the topic. Hopefully, 
we have inspired you to make your own creations 
and we would love to see what you have made with 
this set. We might revisit this set sometime in the 
future, though, for some more fun. Hi 


Disclaimer 


LEGO® is a trademark of the LEGO Group of 
companies, which does not sponsor, authorise, or 
endorse this article. 
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Si-clops.py (continued) 


186. 
187. 
188. 
189. 
190. 
191. 
192. 
193. 
194. 
195. 
196. 
197. 
198. 


199. 


200. 


201. 
202. 


203. 
204. 
205. 
206. 
207. 
208. 
209. 
210. 
211. 
212. 
213. 


214. 
215. 


216. 
217. 


218. 


219. 


220. 


221. 


222. 


223. 


224. 


225. 


226. 


227. 


228. 
229. 


drawWords("Velocity",218,54,(0,0,0), backCol) 
drawwWords("Voice",285,54,(0,0,0), backCol) 
drawWords("Mute",370,54,(0,0,0), backCol) 
drawWords("Tempo",10,324,(0,0,0), backCol) 
drawWords("X10",112,366,(0,0,0), backCol) 
drawWords("BPM",40,366,(0,0,0), backCol) 
drawwWords("Sample",180,340,(0,0,0), backCol) 
pygame.draw.rect(screen, lineCol,driveRect,1) 
updateValues() 

updateSamples(-1) 


def updateSamples(point): 
for i in range(@,samples): + draw sample 
sequence 
pygame.draw.rect(screen, tileColours 
[scannedBlock[i]], sampleRect[i],?) 
pygame.draw.rect(screen, (200,128,0), 
sampleRect[i],1) # outline 
if point !- -1: 
pygame.draw.rect(screen, (200,128,0), 
markerRect[point],9?) 
pygame.display.update() 


def nameNote(index): 
noteNumber - note[index] 
octave - (noteNumber // 12) - 5 
noteInOct = noteNumber % 12 
return str(octave)+"  "4«noteNames[noteInOct]-" " 
def updateValues(): 
for i in range(@,6): 
drawWords (str(chan[i])-" 
(0,0,0), backCol) 
if chan[i] !- 10: 
drawWords (nameNote(i),112,8541i*40,(0,0,0), 
backCol) 
else: 
drawWords(" “+str(note[i])+" 
",112,854i1*40,(0,0,0), backCol) 
drawWords (str(velocity[i])-" 
",204,85+1*40, (0,0,0), backCol) 
pygame.draw.rect(screen, backCol, 
voiceRect[i],2) 
drawWords(str(instNames[ 
сһап[1]-1]),270,85+1*40, (0,0,0), backCol) 
pygame.draw.rect(screen,backCol,muteRect[i],?) 
pygame.draw.rect(screen,lineCol,muteRect[i],1) 
if mute[i]: 
pygame.draw.rect(screen, backCol, muteRect 


",48,8541*40, 


[i],0) 
drawWords( "Mute" ,370,85+i*40, (0,0,0), 
backCol) 
drawWords(str(tempo)+" 
backCol) 
рувате . draw. rect (screen, backCol,rsRect, 2) 
if running: 
drawWords("Stop",300,340,(0,0,0), backCol) 


",10,366,(0,0,0), 


else: 
drawWords("Run ",300,340,(0,0,0), backCol) 
pygame.draw.rect(screen,lineCol,rsRect,1) 
if not newScan: 
pygame.draw.rect(screen, backCol,driveRect,?) 
pygame.draw.rect(screen, lineCol,driveRect,1) 
drawWords("Sample",180,340,(0,0,0), backCol) 
pygame.display.update() 


def drawWords(words,x,y,col,backCol) : 
textSurface = font.render(words, True, col, 
backCol) 
textRect = textSurface.get_rect() 
textRect.left = x # right for align right 
textRect.top = y 
screen.blit(textSurface, textRect) 
return textRect 


def callback_colour(colour, distance): 
global lastColour, updateColour, tileDistance 
lastColour = colour 
tileDistance = distance 
updateColour += 1 


def correctColour(colour): 
if colour > 10: # to correct for not a colour 


colour = @ 
correctColour = colour 
if colour == 5: # to correct for green error in 
sensor 


correctColour = 6 
return correctColour 


def incMotor(): 


global currentMotor, motorUpdate, updateColour, 
step 
inc = 76.39 


currentMotor += inc 
movehub.motor_AB.angled(inc, .4) 
step += 1 # number of steps taken 


def handleMouse(pos): # look at mouse down 

global pramClick, pramInc 

#print(pos) 

if driveRect.collidepoint(pos): 
pygame.draw. rect (screen, hiCol, driveRect, 0) 
pygame.display.update() 

if rsRect.collidepoint(pos): 
pygame.draw.rect(screen,hiCol,rsRect, @) 
pygame.display.update() 

for i in range(0,6): 

if muteRect[i].collidepoint(pos): 

pygame.draw.rect(screen,hiCol,muteRect[i],?) 
pygame.display.update() 

pramClick = -1 

pramInc = ð 
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Si-clops (continued) 


284. for i in range(0,20): 332. pygame.draw.rect(screen,lineCol, 
285. if incRect[i].collidepoint(pos): decRect [pramClick],1) 
286. pramClick - i 333. else: 
287. pramInc - 1 334. screen.blit(icon[90], (incRect[ 
288. pygame.draw.rect(screen,hicol, pramClick].left,incRect[pramClick].top)) 
incRect[pramClick],1) 335. pygame.draw.rect(screen,lineCol, 
289. pygame.display.update() incRect [pramClick],1) 
290. for i in range(0,20): 336. updateValues() 
291. if decRect[i].collidepoint(pos): 337. for i in range(0,6): 
292. pramClick - i 338. if muteRect[i].collidepoint(pos): 
293. pramInc - -1 339. mute[i] - not mute[i] 
294. pygame.draw.rect(screen,hicol, 340. updateValues() 
decRect[pramClick],1) 341. 
295. pygame.display.update() 342. def constrain(val, min val, max val): 
296. if pramClick == 19: # for tempo X10 343. return min(max val, max(min val, val)) 
297. pramInc - pramInc * 10 344. 
298. 345. def call button(is pressed): # scan on hub 
299. def handleMouseUp(pos): # look at mouse up button press 
300. global mute, velocity, note, chan, tempo, 346. global newScan 
running, newScan, midiStep, lastChan 347. if not is pressed : 
301. if rsRect.collidepoint(pos): 348. newScan - True 
302. running - not running 349. pygame.draw.rect(screen,hiCol,driveRect,?) 
303. if not running: 350. pygame.display.update() 
304. alloff() 351. time.sleep(1.0) 
305. midiStep = @ 352. 
306. else: 353. 
307. for i in range(0, samples): 354. def terminate(): # close down the program 
308. lastChan[i]=-1 355. global midiout 
309. updateValues() 356. print ("Closing down") 
310. updateSamples(-1) 357. alloff() 
311. if driveRect.collidepoint(pos): 358. movehub. button. unsubscribe(call_button) 
312. newScan = True 359. movehub.color distance sensor.unsubscribe( 
313. updateValues() callback colour) 
314. 360 conn.disconnect() 
315. if pramClick !- -1: 361. del midiout 
316. if pramClick « 6: 362. pygame.quit() # close pygame 
317. chan[pramClick] += pramInc 363. os._exit(1) 
318. chan[pramClick] = 364. 
constrain(chan[pramClick],1,16) 365. def checkForEvent(): # see if we need to quit 
319. elif pramClick < 12: 366. global shutDown, newScan 
320. note[pramClick-6] += pramInc 367. event = pygame.event.poll() 
321. note[pramClick-6] = constrain(note[ 368. if event.type == pygame.QUIT : 
pramClick-6],15,127) 369. terminate() 
322. elif pramClick < 18: 370. if event.type == pygame.KEYDOWN : 
323. velocity[pramClick-12] += pramInc 371. if event.key == pygame.K_ESCAPE : 
324. velocity[pramClick-12] = constrain(velocity[ 372. terminate() 
pramClick-12],0,127) 373. if event.key -- pygame.K SPACE : 
325. elif pramClick »- 18: 374. newScan - True 
326. tempo += pramInc 375. if event.type == pygame.MOUSEBUTTONDOWN : 
327. tempo = constrain(tempo, 30,820) 376. handleMouse(pygame.mouse.get_pos()) 
328. setTime() 377. if event.type == pygame.MOUSEBUTTONUP : 
329. if pramInc !-0: 378. handleMouseUp(pygame.mouse.get pos()) 
330. if pramInc < 0: 379. 
331. screen.blit(icon[1],( 380. if name == ' main ': 
decRect [pramClick].left,decRect[pramClick].top)) 381. main() 
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Use your Pi to collect 
sensor data to the 
Google Cloud 


OOOOOOOOC!| 


UrsaLeo 


Download our Raspbian package to 
turn your Pi into a Google cloud 
gateway. Display data on dashboards, 
store and download it, use it to drive 


emails, texts and other alerts. 


LEDs indicate BLE, internet and 


Enter code | magpil cloud connectivity 
at account creation to receive Console interface 
a free Pi debug board” Safe power down switch 


ursaleo.com/raspbian 


*Offer available for North America and Europe only | ? ipa 
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Evans 


PJ is a writer, 
Raspberry Jammer, 
and developer. He 
solemnly swears he 
is up to no good. 


@mrpjevans 


| You'll Need 


» At least two rooms 


» One Pi Zero W 
per room 


» One or more willing 
participants 


» One beacon per 
participant, e.g. 
magpi.cc/iGmnAa 


Make a 


Marauders Map 


Make your own Marauder's Map and track your family, pets, 
and friends (or enemies?) using Bluetooth beacons 


Map showed you the location of every 

person in Hogwarts. That map worked with 
magic, but ours will work with Raspberry Pi and 
beacons. Bluetooth beacons are low-energy 
devices that constantly ping out a signal that can 
be read by any device. Typically, they are used 
by museums or supermarkets in conjunction 
with a smartphone app to detect where visitors 
are and offer relevant information. We're going 
to flip this and have people carry the beacons 
with them. Raspberry Pi devices in each room 
will detect someone's presence and update a 
web-based map. 


| n the Harry Potter series, the Marauder's 


Pi Zero W devices are perfect 
for this project, their on-board 
Bluetooth detecting the beacons 
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Get some beacons 


Bl 


uetooth Low Energy (BLE) beacons are 


simple devices that send out a constant signal in 


the form 


of a unique code or URL. Bluetooth 4.0 


capable devices can detect this signal without 
needing to pair. There are a few different standards 
and our project is going to support the two most 


popular: 


iBeacon (Apple) and Eddystone (Google). 


These types of beacons are easily found online 


and tend 


to be small button-sized devices capable 


of running for up to a year on a single battery. 
Alternatively, software is available so you can use 


Raspberry Pi boards and microcontrollers (e.g. 
ESP32) so they act as beacons. 


Beacons come in all shapes 
and sizes. You can even turn 
Raspberry Pi boards and 
microcontrollers into beacons 


Prepare your Pi devices 

Each person is going to carry a beacon 
with them. As they move from room to room, a Pi 
Zero W in each room will detect the presence of the 
beacon and report it back to a designated server 
(which can be one of the Pi devices). Set up each Pi 
with Raspbian Stretch Lite, get them on the WiFi 
network, then update the software: 


sudo apt update && sudo apt -y upgrade 
We need to install a few libraries: 


sudo apt install python3-pip libbluetooth-dev 
sudo pip3 install beacontools[scan] 


Now we can scan for beacons in Python. 


2 Each scanner is going to 
report its findings back to a 
central server Ej 


Get the beacon IDs 

Each beacon has either a unique ID code 
(iBeacon) or broadcasts a web address (Eddystone). 
If you're using iBeacons and the vendor hasn't 
supplied the ID, you'll need to discover it by 
scanning. Create a file containing the code from 
the test.py listing. Save it as test.py and run 
as follows: 


sudo python3 test.py 


All being well, you'll see your beacon's 
transmissions. Make a note of the 32-character 
string just after ‘uuid’. Repeat for each one. 

For Eddystones, instructions will be provided 
on how to set the web address. Set each one to 
http://example.org/name, where ‘name’ is the 
person's first name. 


Install the server software 

Each scanner is going to report its findings 
back to a central server. Pick one of the Pi 
devices for this role, then download the code from 
magpi.cc/Hjhtwi to a directory in your home folder 
called beaconmap. First, install Flask: 


pip3 install flask 


The 
PI-RAUDER’S 
MAP 


Then test the server by running: 
python3 ~/beaconmap/server/server.py 


If you’re on the same machine, open 
http://127.0.0.1:5000 in a browser; otherwise 
you'll need to replace 127.0.0.1 with the IP address 
or host name of the server. You'll see a very boring 
webpage asking ‘Where is everyone?'. CTRL+C will 
stop the server. 


n 


& 


Install the scanners 

On each Raspberry Pi, create a file called 
scanner.py and enter the code from the listing 
here. If you don't fancy typing, install the software 
package from magpi.cc/Hjhtwi and you'll find it in 
the scanner directory. 

The code uses Citruz’s BeaconTools library to 
scan the area for beacon signals in bursts of ten 
seconds. When this happens, the code notes 
the ID/URL provided and gives it a score of one, 
with subsequent transmissions incrementing 
the score. After ten seconds, the scores are sent 
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A Our final web app 


updates as people 
move around the 
house. There's lots 
of scope for getting 
creative here 


TopTip ё 


Signal 
strengths 


To avoid all the 
scanners seeing 
your beacon, 
put it on a low 
power setting 

if available. 
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A With its small size 
and smart casing, the 
Raspberry Pi Zero W 
makes a tasteful 
addition to any room 


TopTip è 


Beacon types 


There are many 
different beacon 
standards; make 
sure you're 
using iBeacon 
or Eddystone for 
this project. 


to the server. The server can compare scores for 
different scanners to work out where someone is, 
eliminating overlapping areas. 


Configure and test the server 

IDs aren’t very useful, so configure the 
server by editing the beacons dictionary. Replace 
each key with a beacon ID and set the value to 
{‘name’: ‘name’ }. (There are more instructions 
in the code.) Add as many as you like. When the 
reports come in from the scanners, we will now 
know who they are! 

You should have something like this: 


beacons - ( 
'b63cc056-6f3a-4a9b-80bf-11ff1c6ff724': { 
'name': "РЈ Evans' 
}› 
'144dd069-e22e-418f -b940-c6224d64b7252' : ( 
'name': 'Jazz The Cat' 


Test the server by starting it as before. If you've 
made any typos in the beacon list, you'll find out 
now. Leave it running. 


07 Configure and 
start your scanners 
Edit scanner.py and replace the value of serverUr1 
with the address of your server. Make sure 
‘/readings’ remains at the end. Then edit room to be 
the Pi’s room or location name. 
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On each scanning Raspberry Pi, enter the 
following command: 


sudo python3 ~/beaconmap/scanner/scanner.py 


Each scanner will scan for ten seconds and then 
report scores back to the server. Check that traffic 
is flowing correctly. The server will echo incoming 
data on-screen. If things are not working, check if 
the server is running a firewall, it needs to allow 
traffic in through port 5000. 


Get tracking 

With scanner.py running on each Pi and 
the server up, take one of your beacons and place 
it next to one of the scanning Raspberry Pi devices. 
After ten seconds, refresh the webpage. Your 
beacon should have been matched and the location 
displayed. Repeat with another Pi. Check the page 
again. Did it move? 

If you get confusing results, the Raspberry Pi 
boards may be too close to each other (Bluetooth 
goes through walls!), causing an overlap. If you can 
set the beacon's power output, it should be as low 
as possible; this increases battery life and accuracy. 


Get creative 

So far, so good, but it's all a bit boring 
on the webpage. Grab your crayons and design 
a map. We're not using any kind of positioning 
technology, so you can have fun and not worry 
about accuracy. Make sure it's nice and big as an 
image (try around 1000x1000 pixels) and save as 
beaconmaps/servermap/static/rooms.png. 

You'll also need some avatars, so grab a selfie 

or screenshot your favourite meme, and create a 
square image 75х75 for each person and save in 
the same directory in the format name.jpg so it 
matches the names in the server configuration. 


Run the advanced server 

We've provided a fancier web server 
using Flask, to make the map a bit more fun. 
Stop the standard server (CTRL+C), configure the 
server.py file in servermap as before, then run 
the following command: 


python3 beaconmap/servermap/server.py 


Give the scanners time to report in and have 

a look at the page. It will probably be a bit of a 
mess, but you can have a look at the code for 
instructions on how to adjust things so your 
avatars appear in the right places. Make sure 
everyone is appearing in the correct location, then 
stop the server and scanners. 


2 Make sure everything 
starts on boot, then runs in 
the background Ø 


Automate all the things 

The final step is to make sure everything 
starts on boot, then runs in the background so 
you don't need to have a Terminal open all the 
time. There are many methods, but the easiest 
way to do this is to edit the rc.local file and add 
our requirements. 


sudo nano /etc/rc.local 
Before the last line that reads exit 0, insert a new 
line and add the following lines. 


For the server: 


/usr/bin/python3 /home/pi/beaconmap/servermap/ 
server.py & 


For each scanner: 


/usr/bin/python3 /home/pi/beaconmap/scanner/ 
scanner.py & 


To test, reboot each device. Everything should now 
run in the background. 
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DOWNLOAD 
Scanner.py THE FULL CODE: 


» Language: Python 3 O magpi.cc/Hjhtwi 


More with beacons 

Now let your imagination get involved. 
What else can you do with these beacons? Try 
modifying the server to alert your smartphone 
when someone arrives in a certain place. Or how 
about a digital Easter egg hunt? Give everyone a 
battery-powered Pi Zero W and hide beacons. Your 
score could be generated automatically as you find 
them. Could you make a box that only opens when 
someone carrying the right beacon approaches? 
Over to you. M 
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import time 
import requests 
from beacontools import BeaconScanner 


serverUrl - "http://127.0.0.1:5000/readings" 
room = "Kitchen" 
beacons - () 


# This function is called whenever a packet is detected 
def callback(bt addr, rssi, packet, additional info): 


# Parse out the type of beacon 
typeOfBeacon = type(packet). name .split('". ).pop() 


# Get the ID of the beacon 

if typeOfBeacon -- "EddystoneURLFrame" : 
beaconId = packet.url 

elif typeOfBeacon == "IBeaconAdvertisement": 
beaconId = packet.uuid 


# Track how many times we've seen this beacon 
if beaconId not in beacons: 

beacons[beaconId] = 1 
else: 

beacons[beaconId] += 1 


# Scan for all advertisements from beacons 
print('Starting beacon scanner’) 

scanner = BeaconScanner(callback) 

scanner. start() 


while True: 


# Allow a 10-second sample to come through 
print('Waiting 10 seconds') 
time.sleep(10) 


# Now send the current scores to the server 
print('Sending to server') 
try: 
response = requests.put(serverUrl, јѕоп={ "поот": room, 
"beacons": beacons}) 
if response.status code -- 200: 
print('Success') 
else: 
print('Got response code: 


* str(response.status code)) 
except: 
print("Communication error") 


# Clean the scores 
beacons = {} 
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Simon Long 

is a software 
engineer working 
for Raspberry Pi, 
responsible for 
the Raspberry 

Pi Desktop on 
both Raspbian 
and Debian. 


rpf.io 


Buttons and labels 
with C and GTK 


Make your empty window more interesting and 
interactive by adding a button and text label 


issue's instalment (magpi.cc/81) draws a 

window on the screen, but it looks rather 
bare. There's also that problem that closing the 
window with the X button leaves the program still 
running. We're going to fix both of those by adding 
a button to close the window. 

A button is another standard GTK widget, and 
it supports all the features you'd expect - you can 
have a label on it; you can see its appearance change 
when you click it; you can activate it with a keyboard 
shortcut; you can even disable it temporarily and 
grey it out. 

The first thing to do is to add the button to the 
window. When we've done that, we can look at 
making it do something useful. Modify the code for 
the previous example as follows: 


T he simple program we looked at in last 


#include «gtk/gtk.h» 


void main (int argc, char *argv[]) 
1 
gtk init (&argc, &argv); 
GtkWidget *win - gtk window new 


An Introduction 


to C & GUI | 
Programming 


AN INTRODUCTION 


A Figure 1 The window with a button on it 


(GTK_WINDOW_TOPLEVEL) ; 


gtk_main (); 
} 


Let’s look at the changes: 


GtkWidget *btn = gtk_button_new_with_label 
("Close window") ; 


This creates a GtkButton widget. There is a standard 
gtk_button_new function, but using this version, 
gtk_button_new_with_label, allows us to add a text 
label to the button at the same time as we create it. 


gtk container add (GTK CONTAINER (win), btn); 


For further tutorials on how to start coding 
in C and creating GUIs with GTK, take a 
look at our new book, An Introduction to 

C & GUI Programming. Its 156 pages are 
packed with all the information you need 
to get started - no previous experience of 
C or GTK is required! 

magpi.cc/GUIbook 


The gtk_container_add function places the button 
Е inside the window. 


gtk widget show all (win); 


Finally, the call to gtk widget show is now replaced 
with a call to gtk widget show all - this tells 
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GTK to show both the named widget and any 
widgets it contains. If this line wasn't changed, 
the window would be shown, but the button would 
remain hidden. 

If you now build and run the code, you'll find that 
you get a (smaller) window with a button labelled 
‘Close window’ displayed on it (Figure 1). 


Containers 
In the example, we use the line: 


gtk container add (GTK CONTAINER (win), btn); 


...to put the button into the window. 

As you've probably noticed, each function call 
in GTK starts with the prefix gtk , which is then 
followed by the name of the widget type upon which 
it operates - so gtk window пем creates a widget 
of type GtkWindow. This function call, therefore, 
operates on widgets of type GtkContainer, but we 
are using it on win, which is a GtkWindow. How does 
that work? 

There is a hierarchy of widget types within GTK, 
and a widget type inherits the properties of its 
parents within the hierarchy; that widget type can 
be described as a child of the widget types above it 
in the hierarchy. 


2 Putting one widget 
inside another like this is 
something we need to do 
quite often Л 


Because GtkContainer is one of the parents of 
GtkWindow, you can use gtk container functions 
on GtkWindow widgets. Many widgets have 
GtkContainer as a parent, because putting one 
widget inside another like this is something we need 
to do quite often. 

You will notice that when win is supplied as an 
argument to the gtk container add function, it 
is wrapped inside the GTK_CONTAINER() function 
- this casts the argument to a variable of type 
GTK CONTAINER; in other words, it tells the function 
call to treat this reference to a GtkWindow as 
a GtkContainer. The code will still work if this 
function isn't included, but the compiler will 
complain! (GTK includes a GTK function for every 
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type of widget, as it is quite common to need to cast 
a widget to a different type.) 

So what this line does is to tell GTK to treat the 
GtkWindow widget win as a GtkContainer, and to 
put the button widget btn into it. 


Signals 
If you run the application, you can click the button 
with the mouse, and it will highlight to show that 
it has been clicked; you can also hit the ENTER key 
on the keyboard to do the same thing - this button 
behaves exactly like the buttons we are used to 
seeing in applications, but it still doesn't actually do 
anything useful. The next step is to fix that. 

The way to do that is to connect a handler function 
to the signal generated when the button is clicked. 
Here's the code with a handler added: 


#include <gtk/gtk.h> 


void main (int argc, char *argv[]) 
{ 
gtk_init (&argc, &argv); 
GtkWidget *win = gtk_window_new 
(GTK WINDOW TOPLEVEL); 
GtkWidget *btn - gtk button new with label 
("Close window"); 
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> Figure 2 This time, 
when you click 
on the button, the 
window will close 


Close window 
1 h 


(end | gram), NUL 

gtk container add (GTK CONTAINER (win), btn); 
gtk widget show all (win); 

gtk main (); 


ў 


The handler function, otherwise known as a callback, 
is called end program, and all it does is to call the 
GTK function gtk main quit - as you'd expect 

from the name, this function exits the loop within 
gtk main and allows the program to end. 


g signal connect (btn, "clicked", 
G CALLBACK (end program), NULL); 


2 All widgets can generate signals under 
various circumstances - mostly when 
interacted with by the user Ej 


This line connects the handler (end program) to 
the signal called clicked, which is emitted by a 
button widget when the mouse is clicked on it. We 
use the GTK_CALLBACK function to make sure the 
compiler knows that the end program function is a 
valid callback. 

Signals are used a lot in GTK; all widgets can 
generate signals under various circumstances - 
mostly when interacted with by the user, but also 
when certain system events occur. Each type of 
widget has a set of signals it can generate; the 
& signal connect function is used to ‘connect’ a 
handler function to them, meaning it will be called 
when the signal is generated. 

Handling signals is one of the most important 
jobs of the main loop which runs inside gtk main - 


60 | magpicc | Buttons and labels with C and GTK 


if a signal is generated, code in the main loop checks 
to see if there is a handler associated with that 
signal, and calls the handler if so. 

Try building and running the new code. We 
now have a button on the window as before, but 
when we click the button, the window closes and, 
importantly, the program exits as well. 

This still isn't perfect, though - if we click the X 
at the top right, the window closes (Figure 2) but 
the program doesn't exit. Let's fix that. 

The way we do this is to connect another 
handler to the signal generated when that X is 
Clicked. The name of this signal is delete event, 
and it is generated from the window widget. So we 
need to connect the same handler to that event 
as well: 


g signal connect (win, "delete event", 
G CALLBACK (end program), NULL); 


Note that we connect to win rather than to btn this 
time - the delete event signal is created by the 
window widget rather than the button. Now if the 
window is closed by clicking the X, the delete event 
signal causes the end program handler to be called 
and the main loop then exits. 

We've now got a GTK application that opens and 
closes cleanly, but it still doesn't do anything else. 
So in the next section, we'll make it do something 
more useful... 


More advanced layout 

We're going to add another button to the window, 
and display a count of the number of times the 
button is pressed. (All we said was that it would be 
more useful than the previous example; we didn't 
say it would be useful for anything people might 
actually want to do!) 


Labels 

For displaying text on a window, we use a widget 
called a GtkLabel - a label is any piece of text which 
can't be edited by the user. (The button we added 
in the previous example contains a label widget, 
which displays the name we gave the button in the 
gtk button new with label call.) 

You can create a label with text already in it, or 
you can create a blank label and add text to it later 
On; you can also change the existing text in a label 
whenever you like. 


Here's the code to add a label to our window: 
#include <gtk/gtk.h> 


void end_program (GtkWidget *wid, gpointer ptr) 


{ 
gtk_main_quit (); 


void main (int argc, char *argv[]) 
{ 
gtk_init (&argc, &argv); 
GtkWidget *win = gtk_window_new 
(GTK_WINDOW_TOPLEVEL) ; 
GtkWidget *btn = gtk_button_new_with_label 
("Close window") ; 
g_signal_connect (btn, "clicked", 
G CALLBACK (end program), NULL); 
g signal connect (win, "delete event", 
G CALLBACK (end program), NULL); 
gtk container add (GTK CONTAINER (win), btn); 


gtk widget show all (win); 
gtk main (); 
} 


Let's look at the new code: 
GtkWidget *lbl = gtk label new ("My label"); 


This creates a GtkLabel called 1b1, with the text ‘My 
label in it. We then call another gtk container add 
to add the label to the window. Build and run the 
code, and see what happens. 

Ah. A window with a button, but no label. What's 
gone wrong? Well, if you look at the Terminal 
window, you can get a clue - you should see an 
error message telling you that a GtkWindow can 
only contain one widget at a time, and that this one 
already contains a GtkButton. 

So you can only put one widget into a window, but 
we want to have two – a button and a label; that's 
not going to work. Unless... 


Boxes 

A user interface toolkit that only allowed you to 
put one thing at a time on a window would be a 
bit limited! So while a window can only contain 
one widget, GTK offers several widgets which 
can be used to hold sets of other widgets. The 
two most useful ones are boxes and tables – we'll 
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stick to boxes for the time being, as they are 
easier to use. 

There are two types of box widget, which are 
called GtkHBox and GtkVBox; these are short for 
‘horizontal box’ and ‘vertical box’, depending 
on how the widgets you put into the box are to 
be arranged. A box widget can hold an unlimited 
number of other widgets, but appears to its parent 
as a Single widget, so can be used to put multiple 
widgets into a window. 

We’re going to use a GtkVBox for this example, so 
modify the code as follows: 


TopTip è 


Compiling and 
running 


For details of 
how to compile 
and run your C 
program using 
GTK, refer to 
part 1 of this 
guide, in issue 81 
(magpi.cc/81). 


#include «gtk/gtk.h» 


void end program (GtkWidget *wid, gpointer ptr) 


1 
gtk main quit (); 


void main (int argc, char *argv[]) 
{ 
gtk init (&argc, &argv); 
GtkWidget *win - gtk window new 
(GTK WINDOW TOPLEVEL); 
GtkWidget *btn - gtk button new with label 
("Close window"); 
g signal connect (btn, "clicked", 
G CALLBACK (end program), NULL); 
g signal connect (win, "delete event", 
G CALLBACK (end program), NULL); 
GtkWidget *lbl = gtk label new ("My label"); 


My label 


9 Figure 3 A GtkLabel 
and a GtkButton 
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> Figure 4 The button 
counting application 
before a button 
is pressed 


gtk_widget_show_all (win); 
gtk main (); 
} 


Let's look at the changes line-by-line: 
GtkWidget *box - gtk vbox new (FALSE, 5); 


This creates a new GtkVBox widget. The two 
parameters to the call are whether or not the 

box is homogeneous – which means it assigns 

the same amount of space to every widget it 

holds - and the spacing in pixels between the 
widgets it holds. So in this case, the box is not 
homogeneous - each widget will only be allocated 
as much space as it needs - and there will bea 
gap of 5 pixels between the two widgets we are 
putting into it. 


gtk box pack start (GTK BOX (box), 161, 
TRUE, TRUE, 0); 

gtk box pack start (GTK BOX (box), btn, 
TRUE, TRUE, 0); 


The gtk box pack start function puts a widget into 
a box. Widgets are added in the order that calls to 
this function are made, and the | start at the end 
indicates that widgets are placed in the box from 
the ‘start’ end, which is the top of a VBox or the 
left-hand side of an HBox. (There is also a 

gtk box pack end function, which adds widgets 
from the bottom or right-hand sides.) 

The function takes five arguments; the first is the 
name of the box we are packing the widgets into, 
and the second is the widget we want to put into the 
box. The remaining three arguments control how 


Figure 4 
= ш}! ps 


My label 


Close window 
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m The window only holds one 
widget, the box, so won't 
complain about holding too 
many widgets Л 


the widget is positioned in the box - we'll look at 
this later on. 


gtk container add (GTK CONTAINER (win), box); 


Finally, we add the box to the window itself – this 
means the window only holds one widget, the box, 
so won't complain about holding too many widgets. 

If you now build and run this, you should see a 
window like Figure 3 (previous page). 

Now we have a window containing the controls 
we need, let's get back to creating our button push 
counter. Here's the code: 


#include <gtk/gtk.h> 


void end_program (GtkWidget *wid, gpointer 
ptr) 
{ 
gtk_main_quit (); 
} 


void main (int argc, char *argv[]) 


{ 
gtk init (&argc, &argv); 


GtkWidget *win - gtk window new 
(GTK, WINDOW TOPLEVEL) ; 

GtkWidget *btn - gtk button new with label 
("Close window"); 

g signal connect (btn, "clicked", 
G CALLBACK (end program), NULL); 


Figure 5 
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Button pressed 3 times 


Close window 


g signal connect (win, "delete event", 
G CALLBACK (end program), NULL); 


GtkWidget *1bl = gtk label new ("Му 
label"); 


GtkWidget *box - gtk vbox new (FALSE, 5); 


БЕК box pack start (GTK BOX (box), lbl, 
TRUE, TRUE, 0); 

gtk box pack start (GTK BOX (box), btn, 
TRUE, TRUE, 0); 

gtk container add (GTK CONTAINER (win), 
box); 

gtk widget show all (win); 

gtk main (); 

} 


We've added a new button, btn2, along with а new 
handler callback function, count button, which 
has been connected to the clicked signal on the 
new button. 


g signal connect (btn2, "clicked", 
С CALLBACK (count button), 161); 


Note that whenever we have used g signal connect 
before, the last argument has been NULL, but 
in this case it is 1b1. The final argument of this 


i. Count button 


9 Figure 5 After the 
'Count button’ 
has been pressed 
three times 


function is a pointer - it can be a pointer to 
anything which the handler might need to use. If 
you look at the arguments to the handler function, 
they are: 


void count button (GtkWidget *wid, gpointer ptr) 


The first argument of a handler for any signal 

is a pointer to the widget that generated the 
signal. Different signals have different numbers 
of arguments in their handler functions, but 
they all have a general- purpose pointer as the 
last argument, and this receives the pointer 
that is supplied as the last argument to the 

g signal connect call. 

In this case, we need to update the text in the 
GtkLabel, so the handler needs access to a pointer 
to the label, and the general-purpose pointer is a 
convenient way of doing this. So we pass the 1b1 
pointer into g signal connect, and in the handler 
we cast this pointer back to a GtkLabel so we can 
use it in the gtk label set text function, which 
updates the text in the label: 


gtk label set text (GTK LABEL (ptr), buffer); 


Sometimes we need to pass more than one 
reference to something to a handler function; 
there are various ways around this like the use of 
structures or global variables, but for simple cases 
like this, the general- purpose pointer works well. 

If you now build and run the code, you should see 
a window which looks like Figure 4. 

When you click on ‘Count button’, the text in the 
label should update on each click (Figure 5). Ш 
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200 pages of 
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RASPBERRY PI 


PROJECIS BOOK 


VOLUME 4 


Amazing hacking and making projects 
from the makers of MdgPi magazine 


Inside: 
Ө How to get involved with the Pi community 
Ө The most inspirational community projects 
© Essential tutorials, guides, and ideas 


Ө Expert reviews and buying advice 


i le © 
С magpi.cc/store 
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MODEL 
RAILWAY 


PRUJELIO 


Want to power up your hobby trains? 
Let's go Pi-powered 
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e see so many hobbies making use of the 
W Raspberry Pi in amazing and novel ways. In 

many cases it makes a hobby more accessible 
(like robotics), or previously difficult tasks a little easier 
(such as advanced wearables). 

One of the oldest electronic hobbies around, model 
railways are intricate and beautiful miniaturised train 
services, long operated in garages and basements. Like 
anything, the technology in them has improved over the 
years, and many people have found ways to incorporate a 
Raspberry Pi into their track layout. So, let’s jump aboard 
and see what projects we can find! 
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CONTROL SOFTWARE 


Some great ways to get started with Pi-powered model railways 


ne of the major benefits of adding a 

Raspberry Pi to a model railway is being 

able to do some custom coding so that 
it runs exactly the way you want it to. There's Hardware Setup Support: Raspberry PI via GPIO 
some software to help you with that... 


GPIO pins 


Rocrail | magpi.cc/WaTTaF 

Rocrail is free, multiplatform software for 
controlling model trains. It allows the user to 
completely, or partially, control an entire railroad 
system via automation and manual control, 
depending on their preferences, and includes a 
more visual, block-based interface for setting up 
the automation. It even has a web client, making 
the manual control easier to access from anywhere. 
This control includes cars, accessories, and lighting 
- it's pretty powerful! 


А JMRI (Java Model Railway Interface) can be run on a 
Raspberry Pi and used to control your railway 


JMR-PI | magpi.cc/puVuFE 

This is a Raspberry Pi port of JMRI, Java-based 
control software suitable for model railways. 
It’s described simply as a way of listening to 
and sending messages on the ‘command bus’. 
In conjunction with the software DecoderPro 
(magpi.cc/wRpmek), it can be used to controla 
model railway. 

JMR-Pi on a Raspberry Pi will work as a control 
box / headless server from which to connect to 
remotely - and thanks to its size, it hides a lot 
better in a railway than a spare computer. 


With Rocrail, multiple user interfaces can be 
accessed from any web-connected device 
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M Rocrail even has a web 
client, making the manual 
control easier to access 
from anywhere Л 


dccpi | magpi.cc/ZFMZBJ 

A Python library specifically optimised for 
Raspberry Pi, it lets you work with the DCC 
protocol, which is used in the control of model 
railways. It's a fairly simple library, able to 
control direction and speed, as well as some 
lights, over GPIO. It also requires a little power 
boost to make sure it provides a signal to the 
tracks, but it's a fun, very DIY solution to 
controlling a train. It makes use of the WiringPi 
library, which could technically also be used on 
its own to control the railway, but dccpi is a lot 
more advanced. 


А The Raspberry Pi needs an additional booster circuit, like 
this one, to actually provide the signal to the tracks 
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Hardware for controlling railways 


SPROG 

sprog-dcc.co.uk 

A HAT for the Raspberry Pi that turns it into a 
DCC interface. 


Digitrax decoder 
digitrax.com 

Digitrax makes a 
number of decoders that 
work on its LocoNet. 


Hornby Elite 
magpi.cc/mLFCkg 

A bit expensive, but it’s 
compatible with a lot of 
this software. 
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Here are some incredible things people have done 
with a model railway and a Raspberry Pi! 
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Lionel Train Switch Control 
magpi.cc/yiLZhx 
Our friends at Dexter Industries put this 
guide together a while ago, showing you how 
to control switches in a model railway using 
a mixture of Arduino and Raspberry Pi. This 
uses a more direct method than DCC, as you're 
controlling the power that activates the switches 
and stuff manually with power. 

While this is quite different to other methods, 
it's an interesting way to program the setup, 
and allows you to use sensors hooked up to the 
Raspberry Pi a little more easily for performing 
automation or adding your own manual buttons 
or controls. Perhaps you could 3D- print your own 
DCC-esque controller with this. 


А You'll need your relay 
to handle 20V AC, so 
make sure to get the 
correct relay, and turn 
the power off before 
connecting it all 
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2 The Internet of Lego is a living project 
where | set out to learn everything 
about the Internet of Things 8 


Internet of Lego 
internetoflego.com 


More than just a model railway, this is an entire 
Lego city, including railway, that is controlled 
by a mixture of Raspberry Pi and Arduino. We 
Spoke to its creator, Cory Guynn, in issue 48 of 
The MagPi (magpi.cc/48). 

“The Internet of Lego is a living project where 
I set out to learn everything about the Internet of 
Things,” Cory told us back then. The train system 
is his favourite part, as he loves to see stuff in 
motion. There's a train-scheduling system built 
upon the Transport for London API, showing the 
destination on an OLED screen and changing the 
tracks to match it. 

It makes use of WiFi, infrared, wired sensors, 


A Multiple Pi devices and Arduinos work in conjunction Ў 
to control the city and more to control not only the train and 


switches, but also the screens and other parts of 
the giant IoT Lego city. 
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m it's a great way to learn about all the 
low-level electronics and code involved 
in a pre-existing system Л 


e Overview 


Learn all about Hall 
effect switches from 
Petter Wallen's setup 


Raspberry Pi Model 
Railway Automation 


If you want to get into the real nitty-gritty of 
controlling your model railway, we recommend 
taking a look at Peter Wallen's project. It makes 
use of the XPressNet protocol, which is one of the 
many ways you can control DCC devices. While the 
code is written in Python, it sends commands to 
the command line to activate specific addresses of 
things connected to the Pi, so it's very low-level. 

It's a great way to learn about all the low-level 
electronics and code involved in a pre-existing 
system, though, and there are some example 
scripts available to help you get started 
integrating it into your own railway. 
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CDP Studio is a development platform for industrial control systems, now coming with a free 


version for non-commercial use. The system can run on a Raspberry Pi, supports C++, open source 
libraries and has a large feature toolbox including GPIO, I2C and MQTT. Its built in GUI design tool 
and features lets you code less and do more. 


Free download on 


CDP Technologies AS 
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Wimborne Model Railway 


Model railways are more than just the locomotive 
making its way around - there's also the miniature land 
set up around it! Wimborne Model Town in Dorset is home 
to a large model railway in a very intricate miniature town. 
All the houses have lights, and there several lamps and 
street lights in the model as well. 

A few years ago, a volunteer named Terry Coles at the 
model town upgraded the light system so it could be 
controlled via a Raspberry Pi. There are two sets of lights: 
the ones in the miniatures, and a big strip of LEDs that 
acts as a sun for the model railway. A day-night cycle 
exists in the model railway, with the LEDs lighting up the 
entire thing as if it was the middle of the day, before slowly 
turning off to represent a sunset. As this happens, lights 
in the model start turning on in sections, resulting in a 
dark night highlighted by the little lights of the model. 

It's programmed in C and makes use of WiringPi. One of 
the cleverer parts of the project is having the OS load into 
memory so that when power is pulled from the Pi, it won't 
have a chance to corrupt the SD card. 


MägPi 
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PiBug 2WD Robot 


> Atronix > magpi.cc/oUtoHY Ъ #24 / $31 


Аааа An easy-to-build, two-wheeled robot that uses the 
‘Yellow’ motors, Raspberry Pi as part of its chassis 
1:48 ratio, 
nominally 
200rpm at 
6V, with JST he annual Pi Wars event always inspires Screw-together brass hex pillars are used as 
connectors T more people to get involved in robotics, but mounts for the two DC motors, creating a sturdy 
POWER: where's the best place to start? Probably rectangular framework between them. One thing 
6 x AA batteries an inexpensive, entry- level kit like the PiBug. to note is that the 30 mm vertical pillars have 
(not supplied) What's really clever about this two-wheeled robot slightly different ends, so you need to check that 
OPTIONAL is that your Raspberry Pi is used as a structural the rounded ones are on the bottom. 
SENSORS: component of the robot's body, so you don't need The other pillar ends are connected to two of 
Line-follower to buy or create a separate chassis. This makes the Raspberry Pi's mounting holes using short 
board (2 x the robot much easier and quicker to get up and (9mm) pillars. The semicircular castor board is 
IR sensors), running, particularly as no soldering is required. then fitted under the front of the Pi, using more 
ultrasonic pillars. Note that if you want your robot to do 
and Buggy building line-following, the standard castor board can 
Online step-by-step assembly instructions be replaced with one featuring two line sensors 
(magpi.cc/xDQQTw) show how to assemble all (available separately for £6). 
the parts to build your PiBug, which should take Next, the PiBug motor controller board is slotted 
around 30 minutes. onto the Pi's GPIO header, then secured with more 


Pp Allthe parts you 
need to build your 
PiBug robot - you 
just need to supply 
the Raspberry Pi 
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short pillars - onto which the battery holder board 
is mounted. The robot and Pi are both powered by 
Six AA batteries; rechargeables are recommended. 
The final stage involves some simple 
connections. The motor wires have JST connectors 
that fit into slots on the motor controller board 
- much easier than screw terminals. If using line 
sensors, their female connectors slot onto pins 
at the rear of the motor controller board; this 
leaves six spare pins, connected to GPIO pins and 
power/ground, to use as you wish - along with a 
push-button on the board. An optional HC-SRo4P 
ultrasonic distance sensor (available for £2.22) is 
connected via four small holes in the battery board. 


In the driving seat 
With the PiBug robot assembled and wired, you 
can start playing with it! A flick of a switch on the 
side turns on the power to the robot and Raspberry 
Pi. Once booted up, you can start coding using the 
PiBug Python library, which comes with a trio of 
examples to get you started. 

As well as code to test the IR line-follower and 
ultrasonic distance sensors, if fitted, there’s a 


enoyo Ste. 
Sa 


sr — 


2 Your Raspberry Pi is used 
as a structural component 
of the robot's body Ø 


program that enables you to drive the PiBug around 
manually via key presses on a remote computer via 
an SSH connection. The robot is pretty nippy and 
agile, zipping along at pace and spinning on its two 
wheels to quickly change direction. Ours didn’t 
run in a perfectly straight line by default, but you 
could always alter the library code to calibrate the 
motors. The PiBug also struggled to set off from 

a stationary position at the lower speed settings, 
although it worked fine at a lower speed after 
slowing down from a faster pace. The low position 
of the castor board also prevents it navigating 
major bumps in the terrain. 

Still, for an entry-level robot, it works well 
enough and is a lot of fun. Naturally, you can use 
the Python library to create your own code to make 
the PiBug move autonomously, using the optional 
sensors to avoid obstacles and/or follow lines. El 
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A Along with 


numerous hex 
pillars, the Raspberry 
Pi forms part of the 
robot's chassis 


Verdict 


While it's a little 
more expensive 
than the CamJam 
Edukit #3, the use 
of the Raspberry 
Pi and hex pillars 
to form a chassis 
is ingenious and 
makes for a cool- 
looking buggy. 


8 10 
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LibreELEC 9.0 Leia 


KODI VERSION: 


18 ‘Leia’ 


COMPATIBILITY: 
All Raspberry Pi 
versions 


INSTALLATION: 
Graphical 
wizard or 
burnable image 


EMULATOR 


API: 
Libretro 


IMAGE SIZE: 
123MB 


"W The familiar interface 


is still there 


Movies 


TV shows 


Music 


TV 


Games 


Add-ons 


Videos 


Weather 


Play your personal games or download 


> LibreELEC » libreelec.tv > Free 


The latest version of this 'Kodi OS' brings Kodi 18's star new feature: 
retro game emulators. Rob Zwetsloot sees if they're worth the fuss 


e love testing out a new Kodi version 
W with new features here at The MagPi - 

the Raspberry Pi powers media centres 
the world over, and we like to see how much 
they improve. Kodi's development is changing 
slightly, so this may be the last time we make sure 
to do a review for a new numbered version, or in 
this case LibreELEC. 

LibreELEC 9.0 is the latest version of our 
favourite HTPC OS for the Pi, built around the 
newest Kodi 18. As well as the usual minor tweaks 
and bug fixes behind the scenes (including a 
nice little update to the settings layout), the real 
selling-point of the new Kodi is native support for 
retro game emulators. 


Join the party 

For years now, you have been able to play games 
on Kodi. However, it was not something properly 
supported by Kodi itself - you just had to install 
the right add-ons and such. 

That's all changed here, with a wide selection 
of popular console emulators and controller maps 
made available using Libretro, which is part of the 
core Kodi system. 


the many game add-ons from the official 


s main menu item 
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ZA SPEED > ~ ~ 
5E HHBSS1HBHB — HSEHEHSBBBH THE4 = 53:5 


А Notallthe emulators run as well as we'd like - the homebrew Blade 
Buster was slugging on some, with washed out colours 


The tech is all there, and it’s all pretty old, so it 
should be a simple addition to Kodi and LibreELEC. 
Or at least you would think, especially going by the 
handy new Games item in the default menu. This 
menu lets you install any of 
these emulators, but that’s 
about it. Games can be 
launched by going into the 
file manager in settings and 


Verdict 


BEER iid The game 
finding your ROM, which is emulation stuff 
quite awkward. generally works, 

This is only temporary, but it's not 
according to the dev team, properly baked 


in yet. Still, if you 
just want to watch 
your videos or 
play music, there's 
nothing better. 


T. 10 


with a game browser 
coming in the future. For 
now, though, all the rest of 
its media abilities work just 
as well as before - it just 
might be best to temper 
any expectations about the 
game- playing aspects. El 


Vilros Raspberry Pi 3 Model B 
Retro Pi Arcade Gaming Kit with 


©. Classic USB Gamepad 
1 edo $09 $1599 


Vilros Raspberry Pi 3 Model B 
Plus Retro Gaming Kit with 2 
Gamepads & Fan-Cooled Retro 


a. 
PSS 2м, 


USE THE CODE FOR 5% OFF | Check us out at 


Crack Coupon Code for 


"Restrictions Apply" "**Offer Expires May 31, 2019" 


Vilros Raspberry Pi 3 Model B+ 
Retro Arcade Gaming Kit With 
Retro Gaming Controller Set 


Vilros Retro Gaming USB Classic 
Controller Set of 5 


-$39.99- $37.99 


(Р (М) (©) Wvilrosusa 
[15225 M ce 
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10 Best: 


Heath 
projects 


Get a clean bill of health with these 
Raspberry Pi projects 


ne of the things we love to see is amazing 

medical and health applications of the 

Raspberry Pi. In our experience, they're usually 
some of the most impressive displays that we see at 
Maker Faires, Coolest Projects, and other events where 
folks are showing off amazing projects. Here are ten of 
the best to inspire you. Ш 


BOINC 


Distributed computing for science 


Lending spare CPU cycles to help cure diseases? Not as crazy as 
you might think: BOINC has been around for ages, and uses your 
idle CPU to help fold proteins or solve equations that can one day 
result in cures and treatments. 


> boinc.berkeley.edu 
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Patient monitor | 


Vital signs HAT 


This project uses the HealthyPi, a HAT for the Raspberry Pi that is 
specifically for medical applications. With it, you can create a full 
ECG which can measure heart rate, SpO2, respiration, temperature, 
and blood pressure. 


> magpi.cc/ikhuAK 


Heartfelt 


Heart monitoring 
through feet 


Preventative care can save 
the NHS a lot of money, and 
the Heartfelt monitor is able 
to detect the symptoms of an 
oncoming cardiovascular event 
from the feet of at-risk patients. When 

an issue is detected, a carer is notified, 
and a quick doctor's visit and medicine will 
mean the patient avoids a trip to the hospital. 


> hftech.org 


LiV Pi 


Air pollution monitor 


Air quality is a big deal in Hong Kong, 
and this Pi-compatible device lets 
you know just how clean your air 

is. It's aimed towards businesses, 
but it's also very useful at home if 
you're living in the big city and have 
concerns over air pollution. 


> livpi.com 


MägPi 


A very early but excellent Pi project, 
where a research scientist turned his 
Pi into an MRI analysis computer. The 
key trick to getting this to work was 
hardware-accelerated calculations, 
as it wouldn't be as well optimised 

in software. 


A usually expensive piece of equipment that allows for timed, 
precise doses of drugs or chemicals from a syringe - whether 
for a patient with an IV, or a scientist running a long-term 
experiment. This version, powered by a Pi, is much cheaper. 


magpi.cc/wPGyPy 


magpi.cc/SWxdSi 


Continuous glucose monitor Battery 


A DIY solution to a normal continuous 
glucose monitor (CGM) that helped 
Dana Lewis perfectly control her insulin 
injections thanks to a bit of machine 

i learning. The Pi itself controls the insulin 
x cd pump using the data from the CGM. 


Raspberry Pi 


: 


Carelink USB 


diyps.org 


This is an incredibly fancy piece of medical tech - a DNA 
imager that uses a Raspberry Pi. It's quick, has modern 
tech conveniences such as a touchscreen, and is an 
all-in-one device. 


magpi.cc/WdpPNQ 


Not every part of medicine is 
glamorous. However, like this 
screening device, it can still save 
lives. The idea is that it's very cheap 
and can be used in poor countries 
where the incidence of gastric 
adenocarcinoma is high. 


magpi.cc/przGLX 


This project pairs the Pi with Bluetooth 
heartbeat sensors that are popular with 
gym equipment, enabling you to get 
more useful stats from a workout than 
your usual treadmill display. Daniel here 
has made data analysis very flexible with 
the code. 


magpi.cc/2kBj0aM 
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Learn artificial intelligence 
with Raspberry P1 


With these resources, your Pi can think for itself. PJ Evans gets (machine) learning 


Google AI Education 


Google 


The Raspberry Pi is a powerful 


Price: 
Free 


ai.google/education 


tool when it comes to artificial 
intelligence (AI) and machine 
learning (ML). Its processing 
capabilities, matched with a 


Machine Learning Crash Course 


low A 


A self-study guide for aspiring 
machine learning practitioners 


small form factor and low power 

requirements, make it a great 

choice for smart robotics and 

embedded projects. Google is 

a champion of the Pi's place 

in the AI world, its AIY voice 

recognition system being given 

away with this very magazine 

(issue 57, no longer available 

in print - magpi.cc/57). 
Google's AI Education site 

is an ideal place to start your 

machine-learning journey. If 

you want to really understand 

how AI/ML works ‘under the 

hood’, there are lot of principles 

to comprehend before you 


even get to coding. Google has 
provided a self-guided suite 
that starts with a ‘Crash Course 
in machine learning, then 
expands to cover the basics 

of problem framing and data 
gathering. The main online 
course comprises 25 lessons 
over 15 hours (approximately, 
you can set your own pace) and 
comes in the form of reading 
materials, interactive sections, 
programming exercises, 

and video tutorials. This is 
then backed by a substantial 
collection of follow-on courses. 
A superb resource. Hl 


2 


Essential websites 


Providers of popular AI/ML tools 


GOOGLE CORAL 

Recently featured in The MagPi #79, this 
exciting new USB accelerator from Google 
transforms the Raspberry Pi's AI capabilities 
by adding a dedicated neural network 


processor. Also, don't miss Google's AIY site. 


coral.withgoogle.com 


OPENCV 
The tool of choice for many robot builders, 
the Open Source Computer Vision Library 


not only gives your Pi sight, but the ability to 
‘comprehend’ what it sees. A powerful tool 
for intelligent object recognition. 
opencv.org 


TENSORFLOW 

If you want implement machine learning on 
a Pi, chances are you'll be using TensorFlow 
to do it. The official site not only features full 
documentation, but also a range of courses. 
tensorflow.org 
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Complete Guide to TensorFlow 
for Deep Learning with Python 


Jose 
Portilla 


Price: 
£195 (often discounted) 


magpi.cc/rbAdNE 


dummy ios 


TensorFlow is, without a 
doubt, the most popular 
software library for machine 
learning on the Raspberry Pi. 
If you're keen to get started 
and write code, TensorFlow will 


4-hour video course that 
covers not only the theory of 
machine learning, but also 


the practicalities of setting up 


the software with real-world 
examples and programming 
exercises. If you're after a 


hands-on learning approach, 


this may well suit. Don't be 


put off by the steep price - this 
course is often promoted and 


was £13 at time of writing. El 


probably be your tool of choice. 
You can get a great introduction 
to TensorFlow in The MagPi #71 
(free download: magpi.cc/71), 
but if you are after a deep dive, 
Udemy offers a comprehensive 


Beginning Artificial 


Intellige 


nce with 


the Raspberry Pi 


Donald 
J Morris 


This book is perfectly 


Price: 
£20 (digital £16) 


magpi.cc/VfrZbO 


tailored to the Raspberry Pi 
community. Not only does it 
cover the principles behind 
concepts such as neural 
networks, fuzzy logic, and 


shallow versus deep learning, 
it also provides practical, fun 


rojects to code and build. 


о № 


Рі at noughts-and-crosses 
and Nim. Along the way, the 


using LEDs and switches to 
bring code to life. You then 


obstacle avoidance and light 


tarting with simple examples 
of learning, you can play your 


projects are made fun through 
the use of the Pi's GPIO header, 


progress to robotics, covering 


ча Donald J. Norris 


seeking. A steady learning curve 


culminates in the building of 


‘Alfie’, your very own artificially 
intelligent robot vehicle. If you 
fancy building the winner of the 
next Pi Wars, this could be the 


perfect reading material. Fl 
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Learn by 


example 


Do you learn by 
doing? Try these 


HOW TO BUILD DIY AI 
PROJECTS USING GOOGLE 
TENSORFLOW AND 
RASPBERRY PI 

А collection of AI/ML projects 
to build or provide inspiration. 
From introductions to 
TensorFlow to a wide range of 
projects including magic mirrors 
and an impressive cucumber 
sorting machine! 
magpi.cc/gLsMHK 


Al ON RASPBERRY PI 
WITH THE INTEL NEURAL 
COMPUTE STICK 

Like Google, Intel has also 
released a USB-based neural 
co-processor. This tutorial is a 
great ‘getting started’ guide, 
talking you through 
installation and on to your first 
facial recognition app. 
magpi.cc/jSShvE 
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RASPBERRY PI POKÉDEX 
PylmageSearch is an 
incredible resource for 
learning OpenCV. This detailed 


tutorial is ideal for younger 
minds, using a Pi and the 
official touchscreen to create 
a Pokédex that can 'recognise' 
plush Pokémon. 
magpi.cc/Ergqjd 
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Nicole 
Parrot 


Home-schooling her kids led Nicole to help others learn to code 


» Category Educator | 


s part of the wider 
A educational mission 

of the Raspberry Pi 
Foundation, there’s been an 
ongoing effort to address the 
low percentage of girls and 
women in computing and 
related spaces. While the overall 
gender balance is disappointing, 
there are still some amazing 
women who have always been 
part of the community, such as 
Nicole Parrot. 


W Computer vision on the Pi 
is remarkably powerful – 
here's Nicole showing off 
its face detection 


(iGetection-retail-00e4/FP16/face-detection-retail-0004.xml -d MYRIAD 
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> Day job CTO | 


“Last millennium I was 
a software developer in the 
special effects industry,” Nicole, 
who currently works at Dexter 
Industries, tells us. “Followed 
by five years at Microsoft in 
3D graphics.” 
Nicole quit in the late nineties 
to home-school her kids, which 
included teaching them and 
other children how to code. 

Her home coding lessons soon 
moved over to schools, and she’s 
helped teachers bring code to 
the classroom. 

“That gives me approximately 
15 years of experience in exposing 
kids to code,” Nicole says. Her 
work at Dexter Industries reflects 
this experience. 


> Website nicole.parrot.ca 


What is your role at 

Dexter Industries? 

Iam CTO for Dexter Industries. 
As such, I manage a small team 
to bring new products to market, 
and create projects. I also manage 
curriculum writing. We want to 
offer teachers the full experience, 
from a stable robot in the 
classroom to prepared lessons, to 
open-ended projects. Our main 
product is the GoPiGo, now in its 
third iteration. We've learned a 
lot about what's needed to make 
a robot for the classroom, and 
this particular robot is the end 
result. It comes packaged with 
DexterOS, based on Raspbian 
with tools that make it usable out 
of the box. [...] Within DexterOS 


A This fake snowman is powered by Pi, and manages to survive the cold Québécois winters 


we have Bloxter, a block-based 
language, and Python available, 
again all within the browser. 
I'm quite proud of this project, 
to be honest. 


What inspires you? 
Kids! And this is from a person 
who used to be entirely career- 
oriented. I used to avoid kids, and 
flee from the room if someone 
would bring their kid with them. 
Then I did a full 360 degrees 
when I got my own. Kids are 
such a gift; their way of thinking 
is magical. Their reactions are 
just awesome when they figure 
out something like a tricky 
piece of code, or lighting up an 
LED for the first time. Sharing 
knowledge (remember that I 
home-schooled, I did all subjects, 
all years, and then some more!) 
is the most inspiring experience I 
can think of. 

Pm also a yarn artist, I love 
natural yarns, and I try to 
buy from local breeders when 
possible. I love to know that this 
particular yarn came from an 


д Within DexterOS we have Bloxter, a 
block-based language, and Python 
available, all within the browser 8 


animal with a name, and I get 

to know that name too. I have 

a source for alpaca yarn that 
allows me to visit the animals in 
question. That way I know they 
are well-treated. 


How did you learn about the 
Raspberry Pi? 

I was an early adopter of the Pi. 
I got my first one at Christmas 
2012. I could not get one before 
that because they were not for 
sale in Canada where I reside 
the first available ones were 
in December. I've been around 
ince the beginning. However, 
had been out of tech for along 
time already by that point, didn't 
remember any electronics, my 
UNIX was entirely forgotten 
except for ‘vi’. I could use vi and 
even exit it if I wasn’t thinking 
about it. Muscle memory is a 


= v 
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Nicole's activities don't just 
limit her to Canada - she's 
also been to Cambridge 
(UK) for Pi Wars, and been 
to the Pi Store 


Amazing 
projects 


Nicole has built some 
impressive things with 
Raspberry Pi - here 

are just a few of them: 


GrovePi Zero 
bike trips 
magpi.cc/MePSpa 
Based on a GPS 
tracker and time- 
lapse photo creator 
that Nicole created 
for long road trips in a 
camper van, you can 
use Google Maps to 
see your trip. 


Holiday wreath 
magpi.cc/DcmEKu 


A Pi-powered wreath 
to put on your door 
during Christmas! 


Dancing 
snowman 
magpi.cc/RPFDkp 
This snowman dances 


to music created by 
Sonic Pi. 


A Nicole teaching data analysis with 
Python for beginners 


funny thing. But there wasn't 
much I could do with the Pi at 
that point. 
I spent quite a few years 
playing catch-up, getting my 
tech groove back. It was funny 
how simple things were tricky 
to get back - I remember having 
trouble getting two embedded 
oops to work - but more 
advanced concepts like recursion 
were a breeze. Hl 
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This Month 
in Raspberry P1 


Coolest Projects 
International 201 


Kids from around the world show off their incredible projects in Dublin! 


e love seeing photos from any Coolest 
W Projects event. The makers, coders, 

and STEAM superstars of tomorrow are 
always at these technology fairs, showing off some 
amazing builds. Coolest Projects International is 


the original and largest of the events, and this year 
was no exception. HI 


01. The venue was huge, and full of 
amazing young makers 


02. Representatives from all the 
countries participating got to 
show their projects 


03. It was even a chance to meet 
some amazing YouTubers 


04. Making in allits forms was 
present at the event 


05. Giant Rock-'em-sock-'em robots 
kept everyone entertained! 


06. Smaller robots also made quite 
a splash at the event 


07. Ever wanted a giant Lego robot 
hand? We do now 


08. Cosplay is definitely making 
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MéigPi 
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MagP1 
Monday 


Amazing projects direct from our Twitter 


0. 


02. 


03. 


04. 


05. 


We love the 
craftsmanship behind 
this wonderful gift 


We havent seen a 
video of this, but we 
hope it sounds fine 
and not creepy 


Now this is a very cool 
technical project - it's 
a Work in progress, but 
we love the idea 


The presentation of 
this project alone is 

enough to warrant a 
Spot here 


Hamsters and the 
internet are always a 
great combination 


very Monday we ask the question: have 

you made something with a Pi over the 

weekend? Every Monday, our followers send 
us amazing photos and videos of the things they've 
made. Here is a small fraction of them. Follow 


along at #MagPiMonday. M 
Replying to 


My teenage son Bill aka @jedifodder made 
this for his mum's birthday, lit by &»pimoro: 
rainbow phat and Pi Zero. 


Brian Corteil 2 
@CannonFodder 


Q Charly Kühnast Follow 04 
@CharlyKuehnast 


Replying to @TheMagPi 


Сы) м 


рро 
@dandomingue 


Replying to @TheMagPi 


Singing rabbit with a pizero, speakerPhat and 
controlled via home assistant 


Leo White qcE 03 
@LeoWhitesTweets 


Replying to @TheMagPi 


| built a PS3 controller to Atari DB9 joystick 
adaptor out of a RPi Zero and a couple of 
logic level converters so | can play games on 
my Commodore 64. 


There's a lux sensor above the Pi's display. As 
light decreases, the Pi gradually fires up the 
lights (Philips Hue and IKEA Tradfri) across the 
living room. The display and two tiny OLEDs 
show the sensor's readings and light status. 


#RaspberryPi #lego 


Replying to @TheMagPi 


An internet controlled and tracked hamster 
wheel! 


8BitsandaByte 
@8BitsandaByte 


~ 
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Universal PRO Nixie 
Tester and Healer 


From the makers of the Nixie HAT, which lets you attach 
a Nixie tube to the top of your Raspberry Pi, comes the 
tester and healer. Nixie tubes may experience problems, 
which are just a natural part of how they work, and this 
device will test and heal many common issues they have. 


igg.me/at/pro-nixietester 


Raspberry Pi Cameras & 
Temperature Sensors: An 
IoT Guide 


Not all projects are physical items - this one is a book which has wise 
Words on environmental sensors and the Raspberry Pi Camera Module 
in relation to loT. The campaign will be finished by the time you read 
this, but it's already successful so give it a look! 


kck.st/2IPhQ7P 


Best of the rest! 


Here are some other great 
things we saw this month 


EVERGREEN WARNING 


“Accidentally fried my Pi, so | turned it into a 
reminder not to do it again..". Extremely wise 
words from Reddit user ironically. maiden. 


> magpi.cc/uFxUrF 


RASPBERRY PI STORE VR 


If you don't live in Cambridge, you may 
never have been to the Raspberry Pi 
Store. Fear not - if you have Google 
Cardboard VR Goggles, you can now look 
around it with this amazing recreation. 


> magpi.cc/EKfGcV 
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7, Mi 


From USD$49.99 Only 
Most convenient DAC for Pi 


No compromise in Audio Quality 


192kHz Sampling Rate / 24bit Resolution DAC 

2 x Precise Crystal as master clock for lower jitter 
Ultra low noise voltage regulator 

Up to 1.5" OLED Colour Display 


Power switch with graceful shutdown 
Full integration with Volumio 

Open source software on github 
Optional Case, Amp, CD Upsampling 
& Extraction Add-ons 


http://nanomesher.com/nanosound 


NENNEN Mägi | EVENTS 


aspberry Jam 
vent Calendar 


Find out what community-organised Raspberry Pi-themed 


events are happening near you... 


01. Beijing Raspberry Jam 


© Monday з June 

Q South Side, No. 9 An Hua Street, Beijing, China 

» magpi.cc/bTFQeK 

Anyone who wants to program, or just to get familiar with 
the Raspberry Pi, can join. 


02. Bake-n-Make your own Raspberry Pi 
© Tuesday 4 June 

9 Seattle Makers, Seattle, WA, USA 

» magpi.cc/cmzdwG 

Come gather with other Pi enthusiasts. Any level of 
experience is welcome. 


03. The All London Raspberry Pi Jam 

© Saturday 8 June 

$ The Microsoft Reactor London, London, UK 
» magpi.cc/NKrVfe 

Aimed at teaching children and parents about 
technology and programming. 


04. Bridport Raspberry Jam 

© Saturday 15 June 

9 Bridport Library, Bridport, UK 

> magpi.cc/FehSPV 

Bridport Jam is back after a hiatus, with some cool 
demos and robots to show off. 
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05. Bognor Regis Raspberry Jam 


© Saturday 15 June 

Q9 University of Chichester, Bognor Regis, UK 

» magpi.cc/veSiyh 

An ideal event if you have a Pi and aren't sure what to do 
with it, or you are seeking inspiration for new ideas. 


06. Seattle Raspberry Jam 

© Wednesday 19 June 

9 Bellevue Library, Bellevue, WA, USA 

» magpi.cc/NvsBzz 

Participate in the monthly project, share your 
knowledge. or show a project you've created. 


FULL CALENDAR 


Get a full list of upcomin 
07. Cornwall Tech Jam L Я 


© Saturday 8 June 

9 Penwith College, Penzance, UK 

» cornwalltechjam.uk 

For anyone interested in technology, of all ages and 
abilities. Ask questions and learn about programming. 


events for June and 
beyond here: 


rpf.io/jam 


08. Stafford Raspberry Jam 

© Tuesday 11 June 

Q Stafford Library, Stafford, UK 

> magpi.cc/ioiLdO 

Welcoming anyone that wants to show off their projects, 
or see other people's builds! 


We've highlighted some of the areas 
in need of a Jam! Can you help out? 


EVENTS | MägPi [a 
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- Want a Raspberry Jam 
Ф [1 8$ іп your area? 
& & ö & 6 Want to start one? 
6 Email Ben Nuttall about it: 


і $ jam@raspberrypi.org 
* è 


Raspberry Jam advice: 


Finding a venue 


44 | got one of the first Raspberry Pis and was 
looking to find other people like me who 
had little experience of programming 

and Linux to help and support each other. I 


«99 - 
approached the library to see if they would A. © D 
give us the space and they agreed." 3 AM N 


Simon Belshaw - Exeter Raspberry Jam " o 4 
A 


Every Raspberry Jam is entitled to apply for a 
Jam starter kit, which includes magazine issues, ч 
printed worksheets, stickers, flyers, апа more. GUIDEBOOK 

Get the book here: magpi.cc/2q9DHfQ 
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Raspbe 


Your * 
Letters 


International stamps 


I love the Raspberry Pi stamps 
you have! I wish I could get 
them in the USA - is there any 
chance you'll be releasing them 
over here? 


Jeffrey via Twitter 


The stamps are not actually made 
by us or Raspberry Pi, they're 
made by the Royal Mail, so it's 
not something we can really 

sell you in America. The USPS 
probably wouldn't accept them. 
You can buy a presentation pack 
from the Royal Mail store in 

the UK (shop.royalmail.com) 
and have them sent to the USA 
(delivery is £2.15 via Royal Mail). 
You can read more about why the 
stamps exist in our story about 
them on page 6. 


Contact us! 


> Twitter — (gTheMagPi 

» Facebook magpi.cc/facebook 

» Email magpi@raspberrypi.org 
> Online raspberrypi.org/forums 
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jute 
croco PV. 
cry Pi m programming 


Pi Zero serial interfaces 


I am using a Raspberry Pi Zero 
for my project. Currently Iam 
facing a problem as I need to 
use both a Raspberry Pi Camera 
Module and a Raspberry 

Pi 7-inch touch display. 


Pi displays that work via the 
GPIO pins. Pimoroni and 
Adafruit have made a few (see 
the HyperPixel for an example: 
magpi.cc/WgSmAA); however 
we're unable to find specific 
Unfortunately, the Pi Zero only instructions on how to do this 
includes one CSI connector port for the official display. 

and I don't want to connect All we can suggest is to look for 
that display with HDMI. Is a different 7-inch display, or even 
there any way to map the HDMI switch it out for the HyperPixel 
to GPIO pins? 4.0, as it is a very nice screen. 


Akhil via email 


This is a bit of a tricky one - we 
do know of a few Raspberry 


У The HyperPixel works via 
GPIO pins, and may be 
a good alternative 
for some Pi Zero 
projects 


Event photos 


I like seeing photos from the Coolest 
Projects and other events - I assume 
there's always more than what we 
see in the magazine, though. Is there 
any way we can get to see all the 
photos from these events? 


Margaret via Facebook 


Keep an eye on the websites and blogs 
related to these specific events and 
you may see many more photos than 
those we fit in the magazine. We 

have been trying to get a public photo 
repository going, but it's not as easy as 
uploading an album to Facebook. 

This issue, we have some photos 
that came from Coolest Projects 
International, which you'll be able 
to find more of on the CoderDojo 
website (coderdojo.com). 
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Article repo 


I needed a contents list for 

the issues of your excellent 
magazine to keep track of 
articles and where to find 
them. So I have created an 
Excel spreadsheet from the 
contents pages of each issue, 
which I have converted to a PDF 
file. Would this be of interest to 
the wider readership? 

Here is a link to the folder on 
Dropbox which contains the 
contents list and status PDFs: 
magpi.cc/SPLiNH. 


Delaware via email 


We do get people asking us 
about contents lists like this 
every now and then, so this 
should be very useful to a lot of 


DAC+ ADC 


Zn oe eo 


Play back your MUSIC. 


people! We are testing out an 
open-source list for GitHub; it 
might make it easier to update 
by the community. 

We will admit, though, we 
sometimes need to go through 
old issues and find that the odd 
article is not always listed in the 
contents, so don't always treat 
them as complete. 


Up to 192kHz/24bit 


Connect existing audio 
equipment and stream 
music over the network 


Create a Karaoke box 


Use the Raspberry Pi as 
an effects processor 


Record audio 


Create a web radio station 


www.hifiberry.com 


HackSpace 


TECHNOLOGY IN YOUR HANDS 


THE MAGAZINE 


COMPETITION | MägPi ШЕШШ 


S 


We reviewed the JAM HAT in 
the last issue (magpi.cc/81) 


and thought it was a really 
"neat solution to adding 


buttons, LEDs, and a buzzer 
to a Raspberry Pi.” We've 
now got a few to give away. 


m The JAM HAT is the perfect 
add-on board for taking your 
first steps with the Raspberry Pi 


GPIO pins. Designed for beginners Sut 
; a B 
with GPIO Zero code and examples Л 


- ModMyPi MODMYPI 


In association with 


Head here to enter: magpi.cc/win | Learn more: magpi.cc/]MxZCU 


Terms & Conditions 


Competition opens on 29 May 2019 and closes on 28 June 2019. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi Foundation, the 
prize supplier, their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants' details 
will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram or Facebook. 
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It's all about community 


Being important is nice, but being nice is important. By Alex Bate 


s Social Media Manager for 
A Raspberry Pi, I always try 

to encourage the members 
of our wonderful community to 
publish their makes online: write 
blog posts, create online tutorials, 
publish videos. We don't mind what 
you do, so long as we get to share in 
the excitement of those people using 
our product, and see what incredible 
creations you're all building. 

But when we ask others to share 
their creativity publicly, we're also 
asking them to expose a greater part 
of themselves to the wider online 


you share with us, we appreciate it. 
And while I may not dedicate a blog 
post to your build, I can assure you 
that I've discussed it aloud, or shared 
it with the team via Slack or email. 


Stay positive 

Recently, while interviewing an 
influencer for my podcast, How 
Does Social (howdoessocial.com), 
about her experiences as a YouTuber, 
I became even more aware of the 
way in which so many creatives 

are exposed to negativity online. 
And while we can continue to tell 


M Ensure that the small bubble of the internet 
in which you exist is a positive one Л 


world, and, sadly, to the negativity 
that can often exist across social 
media platforms, such as Twitter, 
YouTube, and Reddit. 

Гуе always strived to help create an 
online safe space for our community. 
While some may feel the need to post 
negativity and spread anger, I’ve 
always aimed to ensure that the our 
small chunk of the internet continues 
to be a safe, welcoming environment 
for those who wish to join in with 
the conversation, and expand their 
Raspberry Pi knowledge. Whatever 
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ourselves that the motivation of 
online trolls is often due to jealousy 
and misinformation, this doesn't 
lessen the blow when someone 
posts harsh comments about a 
project you've dedicated your blood, 
sweat, and tears to - a project you're 
infinitely proud of. 

And what I want to say is this: 
please don't be put off. For every 
troll, every negative comment, 
there are a hundred people in awe of 
what you've done. And every time 
you share your excitement at your 


latest creation, we're there in the 
background, cheering you on. 


A little respect 
Remember to always protect your 
mental health when it comes to 
existing in the online world, and 
to treat others how you wish to be 
treated. Take five minutes between 
writing a tweet and sending it, to 
ensure you're happy with it. Post 
positive comments on YouTube, 
share the good points of your day, 
save customer service complaints for 
email and webforms, and ask a friend 
to read the comment section for you 
if it gets too much. Ensure that the 
small bubble of the internet in which 
you exist is a positive one, and that 
the message you share online is one 
of respect and peace. Never feed 
the trolls. Ignoring negativity is the 
best way to ensure it doesn't grow — 
because who continues talking when 
it's obvious that no one is listening? 
Peace and love to you all. Your 
friendly neighbourhood internet 
caretaker, Alex. Hl 


Alex Bate 


Social Media Manager for Raspberry Pi. 
Podcaster and maker. 


@alexjrassic 
howdoessocial.com 
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Build your own credit card 
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